Capture an authorized payment

To ‘capture’ an authorized payment means to make the payment ready for settlement, which is the process by which funds are transferred from your customer to your account overnight.

Only ‘captured’ payments will settle the requested funds to your account, so it is important that, if you are using the ‘AUTH’ transaction mode, you always capture these payments when you are ready to fulfil the service/product you are providing to your customer.

Processing transactions in ‘SALE’ mode, in contract, will automatically ‘capture’ the payment on your behalf once the successful authorization has taken place.

Using the method below, you may capture either the full authorization amount or a partial amount, but the sum of all captures may not exceed the original authorization value.

HTTP Request Method: POST

Resource (URI): https://api-gateway.sandbox.ngenius-payments.com/transactions/outlets/[outlet-reference]/orders/[order-reference]/payments/[payment-reference]/captures

Dynamic resource (order JSON; ‘index’ will be zero unless recurring payment):
response._embedded.payment[index]._links.[“cnp:capture”].href

💡
Note on Index Usage
In most one-time payment scenarios, the relevant payment or capture object will be at index 0 of the _embedded array.
If you're working with recurring payments (like subscriptions), an order may contain multiple payment or capture entries.
In such cases, make sure to reference the appropriate index that matches your use case:
response._embedded.payment[0] // first payment  
response._embedded.payment[1] // second payment (if recurring)
You can always inspect the state or reference fields to identify the right one.

Headers:

Key	Value
Authorization	Bearer [access_token]
Content-Type	application/vnd.ni-payment.v2+json
Accept	application/vnd.ni-payment.v2+json

Body / Form Data:

Attribute	Example value	Description
amount { }	N/A	Amount block
amount.currencyCode	AED	Currency code (must match the currency code of the original authorization).
amount.value	100	Amount value (must not exceed the original authorization amount)

Example request (body):

{
  "amount": { "currencyCode": "AED", "value": 100 }
}

Example response (body)

{
    "_id": "urn:payment:07a6f2b4-2102-4585-9957-09a4c1a342d0",
    "_links": {
        "self": {
            "href": "https://api-gateway.sandbox.ngenius-payments.com/transactions/outlets/670bfc06-63d6-472b-af75-ad0207ac44f5/orders/9079f08f-cec4-48c8-b31a-12fd1305e8f1/payments/07a6f2b4-2102-4585-9957-09a4c1a342d0"
        },
        "curies": [
            {
                "name": "cnp",
                "href": "https://api-gateway.sandbox.ngenius-payments.com/docs/rels/{rel}",
                "templated": true
            }
        ]
    },
    "reference": "07a6f2b4-2102-4585-9957-09a4c1a342d0",
    "paymentMethod": {
        "expiry": "2029-04",
        "cardholderName": "John Brown",
        "name": "VISA",
        "pan": "411111******1111"
    },
    "savedCard": {
        "maskedPan": "411111******1111",
        "expiry": "2029-04",
        "cardholderName": "John Brown",
        "scheme": "VISA",
        "cardToken": "dG9rZW5pemVkUGFuLy92MS8vU0hPV19OT05FLy8xMTExMTExNDExMTExMTEx",
        "recaptureCsc": true
    },
    "state": "CAPTURED",
    "amount": {
        "currencyCode": "AED",
        "value": 12345
    },
    "updateDateTime": "2025-04-15T11:46:28.260061015Z",
    "outletId": "670bfc06-63d6-472b-af75-ad0207ac44f5",
    "orderReference": "9079f08f-cec4-48c8-b31a-12fd1305e8f1",
    "originIp": "196.5.8.18",
    "authResponse": {
        "authorizationCode": "AB0012",
        "success": true,
        "resultCode": "00",
        "resultMessage": "Successful approval/completion or that VIP PIN verification is valid",
        "mid": "10089865858",
        "systemAuditTraceNumber": "080352",
        "rrn": "510411080352"
    },
    "3ds2": {
        "eci": "05",
        "transStatus": "Y",
        "messageVersion": "2.2.0",
        "acsReferenceNumber": "00001ACS00001",
        "threeDSMethodURL": "https://paypage-uat.ngenius-payments.com/fake/3ds2/method",
        "threeDSServerTransID": "717ad219-41cf-4f2d-9322-bc47b809488a",
        "acsURL": "https://paypage-uat.ngenius-payments.com/fake/3ds2/acs?challengeNotificationUrl=https%3A%2F%2FnotificationURL.com",
        "acsTransID": "f345fd20-03e0-4ccb-8e3f-dc44a0535d08",
        "directoryServerID": "M000000004",
        "base64EncodedCReq": "eyJ0cmFuc1N0YXR1cyI6IkMiLCJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjcxN2FkMjE5LTQxY2YtNGYyZC05MzIyLWJjNDdiODA5NDg4YSIsIm1lc3NhZ2VWZXJzaW9uIjoiMi4yLjAiLCJjaGFsbGVuZ2VDb21wbGV0aW9uSW5kIjoiMDEiLCJtZXNzYWdlVHlwZSI6IjAxIiwiYWNzVHJhbnNJRCI6ImYzNDVmZDIwLTAzZTAtNGNjYi04ZTNmLWRjNDRhMDUzNWQwOCJ9"
    },
    "mid": "10089865858",
    "_embedded": {
        "cnp:capture": [
            {
                "_links": {
                    "self": {
                        "href": "https://api-gateway.sandbox.ngenius-payments.com/transactions/outlets/670bfc06-63d6-472b-af75-ad0207ac44f5/orders/9079f08f-cec4-48c8-b31a-12fd1305e8f1/payments/07a6f2b4-2102-4585-9957-09a4c1a342d0/captures/9c47c315-c530-45cd-86c7-d94f9d6542cf"
                    }
                },
                "amount": {
                    "currencyCode": "AED",
                    "value": 12345
                },
                "createdTime": "2025-04-15T11:46:28.260024614Z",
                "state": "SUCCESS"
            }
        ]
    }
}

💡Note on Index Usage

Headers:

Body / Form Data:

💡
Note on Index Usage