Heads up, our devs are blazing ahead—docs are catching up, so some features might not be fully documented yet.

OrderSettlement

OrderSettlement

List order settlements

get
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements

List all settlements for an order.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
orderUidstringRequired

Reference to an Order.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
Responses
200

Example response

get
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements
200

Example response

Create a new order settlement

post
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements

Create a new settlement for an order.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
orderUidstringRequired

Reference to an Order.

Pattern: ^[A-Za-z0-9-_]+
Body

Create a new settlement

amountintegerRequired

in cents, e.g. 1,50 as 150

deviceIdentifierstringOptional
externalIdstringOptional

External reference for the settlement

storePaymentMethodUidstringRequiredPattern: ^[A-Za-z0-9-_]*
settlementUidstringOptionalPattern: ^[A-Za-z0-9-_]+
Responses
200

Example response

application/json
post
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements
200

Example response

Get order settlement details

get
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements/{settlementUid}

Get details for a specific settlement on an order.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
orderUidstringRequired

Reference to an Order.

Pattern: ^[A-Za-z0-9-_]+
settlementUidstringRequired

Reference to a settlement on an order.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
checkStatusbooleanOptional

Check external payment gateways and fetch status

includeDisplayMessagesbooleanOptional

Include display messages in the response

Responses
200

Example response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements/{settlementUid}
200

Example response

Delete an order settlement

delete
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements/{settlementUid}

Delete a settlement on an order.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
orderUidstringRequired

Reference to an Order.

Pattern: ^[A-Za-z0-9-_]+
settlementUidstringRequired

Reference to a settlement on an order.

Pattern: ^[A-Za-z0-9-_]+
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
forceDeletebooleanOptional

Force Delete on a settlement

Responses
delete
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements/{settlementUid}

No content

List payments for settlement

get
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements/{settlementUid}/payments

A payment belongs to an order settlement with payment method INVOICE. Normally invoices are paid via bank and the payments imported or also registered by hand. But if a customer pays the invoice by another method in the store (e.g. cash or card), it is made as a settlement on a new order without any lines, and then shown as paymentSettlement.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
orderUidstringRequired

Reference to an Order.

Pattern: ^[A-Za-z0-9-_]+
settlementUidstringRequired

Reference to a settlement on an order.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Responses
200

Example response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements/{settlementUid}/payments
200

Example response

Add payment for settlement

post
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements/{settlementUid}/payments

Add a payment for a settlement. amount is in cents. If paidAt is nil, it is set to now.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
orderUidstringRequired

Reference to an Order.

Pattern: ^[A-Za-z0-9-_]+
settlementUidstringRequired

Reference to a settlement on an order.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Body
amountintegerRequired
paidAtstring · date-timeOptional
externalReferencestringOptional
paymentUidstringOptionalPattern: ^[A-Za-z0-9-_]*
Responses
post
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements/{settlementUid}/payments
201

Example response

Create new payment-settlement

post
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements/{settlementUid}/payment-settlements

A payment belongs to an order settlement with payment method INVOICE. Normally invoices are paid via bank and the payments imported or also registered by hand. But if a customer pays the invoice by another method in store (e.g. cash or card) it is made as a settlement on a new order without any lines, and this is what we do here, meaning the path parameters must refer to the order and settlement for which this is a payment.

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
orderUidstringRequired

Reference to an Order.

Pattern: ^[A-Za-z0-9-_]+
settlementUidstringRequired

Reference to a settlement on an order.

Pattern: ^[A-Za-z0-9-_]+
Body

Create a new settlement

amountintegerRequired

in cents, e.g. 1,50 as 150

deviceIdentifierstringOptional
externalIdstringOptional

External reference for the settlement

storePaymentMethodUidstringRequiredPattern: ^[A-Za-z0-9-_]*
settlementUidstringOptionalPattern: ^[A-Za-z0-9-_]+
Responses
post
/tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/settlements/{settlementUid}/payment-settlements
201

Example response

Search in settlements

post
/tenants/{tenantUid}/organizations/{organizationUid}/settlements/search

Retrieves a filtered list of settlements for the organization. Results are sorted by createdAt in descending order when no sorting parameter is specified. The spreadsheet response is a report containing only key settlement fields (pagination does not apply to spreadsheet responses).

Authorizations
AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
organizationUidstringRequired

Reference to an organization.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
Body
storeUidsstring[]Optional
storePaymentMethodUidsstring[]Optional
settlementCodestringOptional
externalIdsstring[]Optional
externalPaymentReferencesstring[]Optional
hasEhfInvoicebooleanOptional

EHF = "Elektronisk handelsformat"

hasPaymentBalanceOutstandingbooleanOptional
Responses
200

Example response

post
/tenants/{tenantUid}/organizations/{organizationUid}/settlements/search
200

Example response

Last updated

Was this helpful?