To create a Delayed Charges transaction, both the Delayed Charges and Pay By Token services must be enabled for the merchant. This feature is applicable only to Unscheduled Auth or Single Auth transactions. A Delayed Charges transaction is a Purchase transaction initiated by the merchant against a previously authorized and captured parent order to collect additional fees beyond the originally captured amount.
Key Requirements:
The parent order must be an AUTH order (either Single or Unscheduled).
While the parent order is an AUTH, the Delayed Charges transaction will be a Purchase.
The Delayed Charges amount must be greater than 0.
The original parent order should be fully captured before delayed charges can be charged.
The Delayed Charges action is available only within the number of days configured in the merchant’s MIT configuration, counted from the original order’s creation date.
HTTP Request Method: POST
Resource (URI): https://api-gateway.sandbox.ksa.ngenius-payments.com/transactions/outlets/{outletId}/orders
Headers:
Add these headers to your request (note that you should replace 'access_token' with the access token value we received from the Request an access token step).
| Header | Value |
|---|---|
| Authorization | Bearer access_token |
| Content-Type | application/vnd.ni-payment.v2+json |
| Accept | application/vnd.ni-payment.v2+json |
Body:
Add the following JSON information to the form/body content of your request.
| Attribute | Description | Example |
|---|---|---|
| action | Payment processing method | 'PURCHASE' |
| frequency | Frequency/interval of payment | Various (see below) |
| emailAddress | Customer email address | [email protected] |
| amount | amount data block | N/A |
| amount.currencyCode | Order currency | 'SAR' |
| amount.value | Initial amount | 1000 ( = 10.00 SAR) |
| delayedChargesDetails | delayedChargesDetails data block | N/A |
| delayedChargesDetails.parentOrderId | Parent order id for which the delayed charges are being charged | [UUID] |
Example request (body):
{
"action": "PURCHASE",
"emailAddress": "[email protected]",
"amount": {
"currencyCode": "SAR",
"value": 10000
},
"delayedChargesDetails": {
"parentOrderId": "5475144d-6783-4df7-a40b-e195bc8bcaa7"
}
}
Example response (body):
{
"_id": "urn:order:4494e6cb-63a3-46c6-9b9c-71a0053316f0",
"_links": {
"self": {
"href": "https://api-gateway.infradev.ksa.ngenius-payments.com/transactions/outlets/63ecfe89-f7b3-4a06-9e12-d218d772020d/orders/4494e6cb-63a3-46c6-9b9c-71a0053316f0"
},
"tenant-brand": {
"href": "http://config-service/config/outlets/63ecfe89-f7b3-4a06-9e12-d218d772020d/configs/tenant-brand"
},
"merchant-brand": {
"href": "http://config-service/config/outlets/63ecfe89-f7b3-4a06-9e12-d218d772020d/configs/merchant-brand"
}
},
"type": "SINGLE",
"merchantDefinedData": {},
"action": "PURCHASE",
"amount": {
"currencyCode": "SAR",
"value": 10000
},
"language": "en",
"merchantAttributes": {},
"emailAddress": "[email protected]",
"reference": "4494e6cb-63a3-46c6-9b9c-71a0053316f0",
"outletId": "63ecfe89-f7b3-4a06-9e12-d218d772020d",
"createDateTime": "2025-06-24T09:50:35.172418137Z",
"paymentMethods": {
"card": [
"MASTERCARD",
"VISA",
"MADA"
]
},
"referrer": "urn:Ecom:5475144d-6783-4df7-a40b-e195bc8bcaa7",
"merchantDetails": {
"reference": "0b4dd17c-ec44-4f30-bef0-7890d91da22d",
"name": "WestZone7812",
"companyUrl": "",
"email": "",
"mobile": ""
},
"delayedChargesDetails": {
"parentOrderId": "5475144d-6783-4df7-a40b-e195bc8bcaa7"
},
"isSplitPayment": false,
"isSaudiPaymentEnabled": true,
"formattedOrderSummary": {},
"formattedAmount": "SAR 100",
"formattedOriginalAmount": "",
"_embedded": {
"payment": [
{
"_id": "urn:payment:7ae68ade-63cd-4095-b455-c6f38b2a6a7f",
"_links": {
"self": {
"href": "https://api-gateway.infradev.ksa.ngenius-payments.com/transactions/outlets/63ecfe89-f7b3-4a06-9e12-d218d772020d/orders/4494e6cb-63a3-46c6-9b9c-71a0053316f0/payments/7ae68ade-63cd-4095-b455-c6f38b2a6a7f"
},
"cnp:cancel": {
"href": "https://api-gateway.infradev.ksa.ngenius-payments.com/transactions/outlets/63ecfe89-f7b3-4a06-9e12-d218d772020d/orders/4494e6cb-63a3-46c6-9b9c-71a0053316f0/payments/7ae68ade-63cd-4095-b455-c6f38b2a6a7f/cancel"
},
"curies": [
{
"name": "cnp",
"href": "https://api-gateway.infradev.ksa.ngenius-payments.com/docs/rels/{rel}",
"templated": true
}
]
},
"reference": "7ae68ade-63cd-4095-b455-c6f38b2a6a7f",
"paymentMethod": {
"expiry": "2026-10",
"cardholderName": "Mustakim",
"name": "MADA",
"pan": "483011******5585"
},
"savedCard": {
"maskedPan": "483011******5585",
"expiry": "2026-10",
"cardholderName": "Mustakim",
"scheme": "MADA",
"cardToken": "ZGE1YTEwMDAtNGIxMi00YzM2LWJkOTUtNDg5YzRjZmRhNTA1",
"recaptureCsc": true
},
"state": "PURCHASED",
"amount": {
"currencyCode": "SAR",
"value": 10000
},
"updateDateTime": "2025-06-24T09:50:36.518276682Z",
"outletId": "63ecfe89-f7b3-4a06-9e12-d218d772020d",
"orderReference": "4494e6cb-63a3-46c6-9b9c-71a0053316f0",
"originIp": "106.213.80.91",
"purchaseData": {
"id": "2cd22753-3452-4d6f-86da-d64fdac67505",
"displayVoid": true,
"displayRefund": false
},
"authResponse": {
"authorizationCode": "123456",
"success": true,
"resultCode": "00",
"resultMessage": "Successful approval/completion or that VIP PIN verification is valid",
"mid": "202506060001",
"systemAuditTraceNumber": "000265",
"rrn": "517509000265"
},
"mid": "202506060001"
}
]
}
}
Response attributes:
| Attribute | Description | Example |
|---|---|---|
| reference | Order reference | [UUID] |
| outletId | The reference of the outlet which accepted the payment | [UUID] |
| delayedChargesDetails | delayedChargesDetails data block |
However, should you wish to interrogate the order further, you may use the 'orderReference' attribute to query the order in more detail (see Retrieve order status for more information on how to do this).