Skip to content

Create a payment

POST
/api/tenant/{tenantId}/Payments
curl --request POST \
--url https://api.nimles.com/e-commerce/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Payments \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "resourceGroupId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "paymentOptionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "orderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "description": "example", "currency": "example", "netAmount": 1, "grossAmount": 1, "country": "example", "buyer": { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "userId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "siteId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "customerType": "example", "identityNumber": "example", "organizationName": "example", "firstName": "example", "lastName": "example", "email": "example", "phoneNumber": "example", "deliveryAddress": { "coAddress": "example", "state": "example", "country": "example", "name": "example", "firstName": "example", "lastName": "example", "street": "example", "postalCode": "example", "city": "example" }, "billingAddress": { "coAddress": "example", "state": "example", "country": "example", "name": "example", "firstName": "example", "lastName": "example", "street": "example", "postalCode": "example", "city": "example" }, "useDeliveryAddress": true }, "seller": { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "userId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "siteId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }, "items": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "orderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "orderItemId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "sku": "example", "name": "example", "description": "example", "unitNetPrice": 1, "unitGrossPrice": 1, "quantity": 1, "netAmount": 1, "vatRate": 1, "grossAmount": 1 } ], "urls": { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "cancel": "example", "terms": "example", "checkout": "example", "confirmation": "example", "push": "example", "addressUpdate": "example", "cancellationTerms": "example", "countryChange": "example", "notification": "example", "shippingOptionUpdate": "example", "validation": "example" } }'

Creates a payment. The payment of an order goes into the order’s resource group, whatever the body says, so access is checked there: completing the payment submits that order and executes its deliveries. Its payment option must be one of that same resource group’s, as at checkout.

tenantId
required
string format: uuid

Your tenant id.

The payment.

Media typeapplication/json
object
resourceGroupId
required

The resource group the item is created in. Required: access is checked there.

string format: uuid
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
organizationId
string format: uuid
nullable
paymentOptionId
string format: uuid
orderId
string format: uuid
nullable
description
string
nullable
currency
string
nullable
netAmount
number format: double
grossAmount
number format: double
country
string
nullable
buyer
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
organizationId
string format: uuid
nullable
userId
string format: uuid
nullable
siteId
string format: uuid
nullable
customerType
string
nullable
identityNumber
string
nullable
organizationName
string
nullable
firstName
string
nullable
lastName
string
nullable
email
string
nullable
phoneNumber
string
nullable
deliveryAddress
object
coAddress
string
nullable
state
string
nullable
country
string
nullable
name
string
nullable
firstName
string
nullable
lastName
string
nullable
street
string
nullable
postalCode
string
nullable
city
string
nullable
billingAddress
object
coAddress
string
nullable
state
string
nullable
country
string
nullable
name
string
nullable
firstName
string
nullable
lastName
string
nullable
street
string
nullable
postalCode
string
nullable
city
string
nullable
useDeliveryAddress
boolean
seller
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
organizationId
string format: uuid
nullable
userId
string format: uuid
nullable
siteId
string format: uuid
nullable
items
Array<object>
nullable
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
orderId
string format: uuid
nullable
orderItemId
string format: uuid
nullable
sku
string
nullable
name
string
nullable
description
string
nullable
unitNetPrice
number format: double
unitGrossPrice
number format: double
quantity
number format: double
netAmount
number format: double
vatRate
integer format: int32
nullable
grossAmount
number format: double
urls
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
cancel
string
nullable
terms
string
nullable
checkout
string
nullable
confirmation
string
nullable
push
string
nullable
addressUpdate
string
nullable
cancellationTerms
string
nullable
countryChange
string
nullable
notification
string
nullable
shippingOptionUpdate
string
nullable
validation
string
nullable

Example generated

{
"resourceGroupId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"paymentOptionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"orderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"description": "example",
"currency": "example",
"netAmount": 1,
"grossAmount": 1,
"country": "example",
"buyer": {
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"userId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"siteId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"customerType": "example",
"identityNumber": "example",
"organizationName": "example",
"firstName": "example",
"lastName": "example",
"email": "example",
"phoneNumber": "example",
"deliveryAddress": {
"coAddress": "example",
"state": "example",
"country": "example",
"name": "example",
"firstName": "example",
"lastName": "example",
"street": "example",
"postalCode": "example",
"city": "example"
},
"billingAddress": {
"coAddress": "example",
"state": "example",
"country": "example",
"name": "example",
"firstName": "example",
"lastName": "example",
"street": "example",
"postalCode": "example",
"city": "example"
},
"useDeliveryAddress": true
},
"seller": {
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"userId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"siteId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
},
"items": [
{
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"orderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"orderItemId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"sku": "example",
"name": "example",
"description": "example",
"unitNetPrice": 1,
"unitGrossPrice": 1,
"quantity": 1,
"netAmount": 1,
"vatRate": 1,
"grossAmount": 1
}
],
"urls": {
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"cancel": "example",
"terms": "example",
"checkout": "example",
"confirmation": "example",
"push": "example",
"addressUpdate": "example",
"cancellationTerms": "example",
"countryChange": "example",
"notification": "example",
"shippingOptionUpdate": "example",
"validation": "example"
}
}

Created. The body is the item, or { data: { id } } when it cannot be read yet. Location is the item’s path within the service, /api/tenant/{tenantId}/{Resource}/{id}, without the /{service} prefix api.nimles.com routes by: use data.id from the body.

Media typeapplication/json
One of:
object
fields
object
key
additional properties
string
data
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
relations
Array<object>
nullable
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
name
string
nullable
entityId
required
string format: uuid
entityType
required
string
>= 1 characters
relationType
required
string
>= 1 characters
tenantId
string format: uuid
nullable
resourceGroupId
string format: uuid
nullable
creatorId
string format: uuid
nullable
createdDate
string format: date-time
nullable
version
integer format: int32
nullable
lastModified
string format: date-time
nullable
paymentOptionId
string format: uuid
orderId
string format: uuid
nullable
paymentNumber
integer format: int32
name
string
nullable
description
string
nullable
paymentType
string
nullable
status
string
nullable
buyer
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
organizationId
string format: uuid
nullable
userId
string format: uuid
nullable
siteId
string format: uuid
nullable
customerType
string
nullable
identityNumber
string
nullable
organizationName
string
nullable
firstName
string
nullable
lastName
string
nullable
email
string
nullable
phoneNumber
string
nullable
deliveryAddress
object
coAddress
string
nullable
state
string
nullable
country
string
nullable
name
string
nullable
firstName
string
nullable
lastName
string
nullable
street
string
nullable
postalCode
string
nullable
city
string
nullable
billingAddress
object
coAddress
string
nullable
state
string
nullable
country
string
nullable
name
string
nullable
firstName
string
nullable
lastName
string
nullable
street
string
nullable
postalCode
string
nullable
city
string
nullable
useDeliveryAddress
boolean
seller
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
organizationId
string format: uuid
nullable
userId
string format: uuid
nullable
siteId
string format: uuid
nullable
items
Array<object>
nullable
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
orderId
string format: uuid
nullable
orderItemId
string format: uuid
nullable
sku
string
nullable
name
string
nullable
description
string
nullable
unitNetPrice
number format: double
unitGrossPrice
number format: double
quantity
number format: double
netAmount
number format: double
vatRate
integer format: int32
nullable
grossAmount
number format: double
netAmount
number format: double
grossAmount
number format: double
currency
string
nullable
dueDate
string format: date-time
nullable
events
Array<object>
nullable
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
userId
string format: uuid
eventType
string
nullable
status
string
nullable
clientIpAddress
string
nullable
paymentProcessorStatus
string
nullable
message
string
nullable
urls
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
cancel
string
nullable
terms
string
nullable
checkout
string
nullable
confirmation
string
nullable
push
string
nullable
addressUpdate
string
nullable
cancellationTerms
string
nullable
countryChange
string
nullable
notification
string
nullable
shippingOptionUpdate
string
nullable
validation
string
nullable
country
string
nullable
paymentProcessor
string
nullable
htmlSnippet
string
nullable
paymentReference
string
nullable
customerReference
string
nullable
credentialReference
string
nullable
paymentProcessorStatus
string
nullable
clientSecret
string
nullable
isPayLater
boolean

Example generated

{
"data": {
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"relations": [
{
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"name": "example",
"entityId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"entityType": "example",
"relationType": "example"
}
],
"tenantId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"resourceGroupId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"creatorId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"createdDate": "2026-04-15T12:00:00Z",
"version": 1,
"lastModified": "2026-04-15T12:00:00Z",
"paymentOptionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"orderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"paymentNumber": 1,
"name": "example",
"description": "example",
"paymentType": "example",
"status": "example",
"buyer": {
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"userId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"siteId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"customerType": "example",
"identityNumber": "example",
"organizationName": "example",
"firstName": "example",
"lastName": "example",
"email": "example",
"phoneNumber": "example",
"deliveryAddress": {
"coAddress": "example",
"state": "example",
"country": "example",
"name": "example",
"firstName": "example",
"lastName": "example",
"street": "example",
"postalCode": "example",
"city": "example"
},
"billingAddress": {
"coAddress": "example",
"state": "example",
"country": "example",
"name": "example",
"firstName": "example",
"lastName": "example",
"street": "example",
"postalCode": "example",
"city": "example"
},
"useDeliveryAddress": true
},
"seller": {
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"userId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"siteId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
},
"items": [
{
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"orderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"orderItemId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"sku": "example",
"name": "example",
"description": "example",
"unitNetPrice": 1,
"unitGrossPrice": 1,
"quantity": 1,
"netAmount": 1,
"vatRate": 1,
"grossAmount": 1
}
],
"netAmount": 1,
"grossAmount": 1,
"currency": "example",
"dueDate": "2026-04-15T12:00:00Z",
"events": [
{
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"userId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"eventType": "example",
"status": "example",
"clientIpAddress": "example",
"paymentProcessorStatus": "example",
"message": "example"
}
],
"urls": {
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"cancel": "example",
"terms": "example",
"checkout": "example",
"confirmation": "example",
"push": "example",
"addressUpdate": "example",
"cancellationTerms": "example",
"countryChange": "example",
"notification": "example",
"shippingOptionUpdate": "example",
"validation": "example"
},
"country": "example",
"paymentProcessor": "example",
"htmlSnippet": "example",
"paymentReference": "example",
"customerReference": "example",
"credentialReference": "example",
"paymentProcessorStatus": "example",
"clientSecret": "example",
"isPayLater": true
}
}
Location
string

The new item’s path within the service, without the service prefix: /api/tenant/{tenantId}/{Resource}/{id}.

Unauthorized: no bearer token, or one that is expired or not for this API.

Forbidden: the caller holds no role that allows this action at this scope. The body is empty, or a problem whose detail names the action.

Media typeapplication/json

An RFC 9457 problem.

object
detail
string
nullable
instance
string
nullable
status
integer format: int32
nullable
title
string
nullable
type
string
nullable
key
additional properties

Example generated

{
"detail": "example",
"instance": "example",
"status": 1,
"title": "example",
"type": "example"
}

Conflict: the item kept changing under concurrent writes; read it again and retry.

Media typeapplication/problem+json

An RFC 9457 problem.

object
detail
string
nullable
instance
string
nullable
status
integer format: int32
nullable
title
string
nullable
type
string
nullable
key
additional properties

Example generated

{
"detail": "example",
"instance": "example",
"status": 1,
"title": "example",
"type": "example"
}

Unprocessable: the body or the change is invalid. The errors are keyed by member.

Media typeapplication/problem+json

A validation problem: the messages by member (or by JSON Pointer for a patch).

object
errors
object
key
additional properties
Array<string>
status
integer format: int32
nullable
title
string
nullable
type
string
nullable
key
additional properties

Example generated

{
"errors": {
"additionalProperty": [
"example"
]
},
"status": 1,
"title": "example",
"type": "example"
}