Create a payment
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Post, RequestUri = new Uri("https://api.nimles.com/e-commerce/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Payments"), Headers = { { "Authorization", "Bearer <token>" }, }, Content = new StringContent("{ \"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\" } }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } }};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}const url = 'https://api.nimles.com/e-commerce/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Payments';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"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"}}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Your tenant id.
Request Body
Section titled “Request Body”The payment.
object
The resource group the item is created in. Required: access is checked there.
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
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" }}Responses
Section titled “Responses”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.
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The id of a new item, when the create answers before the item can be read.
object
object
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 }}Headers
Section titled “Headers”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.
An RFC 9457 problem.
object
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.
An RFC 9457 problem.
object
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.
A validation problem: the messages by member (or by JSON Pointer for a patch).
object
object
Example generated
{ "errors": { "additionalProperty": [ "example" ] }, "status": 1, "title": "example", "type": "example"}