---
updatedAt: 2026-02-26T13:10:36.000Z
agentTools:
  projectIndex: https://docs.ksa.ngenius-payments.com/llms.txt
---

# Retrieve Order Status

Use our API to quickly check the status of your N-Genius order.

You may query the N-Genius Online APIs to retrieve the status/outcome of any order, at any time. Doing so will provide you not only with a full breakdown of the order object, but it will also provide easy-to-use links to any follow-up request you may wish to execute.

**HTTP Request Method**: GET\
**Resource (URI)**: https\://api-gateway.sandbox.ksa.ngenius-payments.com/transactions/outlets/\[outlet-reference]/orders/\[order-reference]

## Headers:

| Header        | Value                   |
| :------------ | :---------------------- |
| Authorization | Bearer \[access\_token] |

Please note that, for the following request types (including this one), no message body data is required, since the HTTP method is either GET or DELETE:

* retrieving an order status
* executing authorization reversals
* cancellation of captures
* cancellation of refunds

**Example response (body)**:

```json
{
    "_id": "urn:order:cac88045-bec0-432a-8fdd-06902da874d2",
    "_links": {
        "cancel": {
            "href": "https://api-gateway.sandbox.ngenius-payments.com/transactions/outlets/670bfc06-63d6-472b-af75-ad0207ac44f5/orders/cac88045-bec0-432a-8fdd-06902da874d2/cancel"
        },
        "payment-authorization": {
            "href": "https://api-gateway.sandbox.ngenius-payments.com/transactions/paymentAuthorization"
        },
        "self": {
            "href": "https://api-gateway.sandbox.ngenius-payments.com/transactions/outlets/670bfc06-63d6-472b-af75-ad0207ac44f5/orders/cac88045-bec0-432a-8fdd-06902da874d2"
        },
        "tenant-brand": {
            "href": "http://config-service/config/outlets/670bfc06-63d6-472b-af75-ad0207ac44f5/configs/tenant-brand"
        },
        "payment": {
            "href": "https://paypage.sandbox.ngenius-payments.com/?code=3cb068fe2f6edeff"
        },
        "merchant-brand": {
            "href": "http://config-service/config/outlets/670bfc06-63d6-472b-af75-ad0207ac44f5/configs/merchant-brand"
        }
    },
    "type": "SINGLE",
    "merchantDefinedData": {},
    "action": "AUTH",
    "amount": {
        "currencyCode": "SAR",
        "value": 12345
    },
    "language": "en",
    "merchantAttributes": {},
    "reference": "cac88045-bec0-432a-8fdd-06902da874d2",
    "outletId": "670bfc06-63d6-472b-af75-ad0207ac44f5",
    "createDateTime": "2025-04-15T08:25:08.171027365Z",
    "paymentMethods": {
        "card": [
            "VISA",
            "MASTERCARD"
        ],
        "wallet": [
            "SAMSUNG_PAY"
        ]
    },
    "referrer": "urn:Ecom:cac88045-bec0-432a-8fdd-06902da874d2",
    "merchantDetails": {
        "reference": "84f95da6-1898-4799-bd36-25df22207e13",
        "name": "Squeaky Chair Productions",
        "companyUrl": "https://network.ae"
    },
    "isSplitPayment": false,
    "formattedOriginalAmount": "",
    "formattedOrderSummary": {},
    "formattedAmount": "د.إ.‏ 123.45",
    "_embedded": {
        "payment": [
            {
                "_id": "urn:payment:b0d21130-f683-442a-b7b3-397461374cdf",
                "_links": {
                    "cnp:3ds2-challenge-response": {
                        "href": "https://api-gateway.sandbox.ngenius-payments.com/transactions/outlets/670bfc06-63d6-472b-af75-ad0207ac44f5/orders/cac88045-bec0-432a-8fdd-06902da874d2/payments/b0d21130-f683-442a-b7b3-397461374cdf/card/3ds2/challenge-response"
                    },
                    "self": {
                        "href": "https://api-gateway.sandbox.ngenius-payments.com/transactions/outlets/670bfc06-63d6-472b-af75-ad0207ac44f5/orders/cac88045-bec0-432a-8fdd-06902da874d2/payments/b0d21130-f683-442a-b7b3-397461374cdf"
                    },
                    "cnp:3ds2-authentication": {
                        "href": "https://api-gateway.sandbox.ngenius-payments.com/transactions/outlets/670bfc06-63d6-472b-af75-ad0207ac44f5/orders/cac88045-bec0-432a-8fdd-06902da874d2/payments/b0d21130-f683-442a-b7b3-397461374cdf/card/3ds2/authentications"
                    },
                    "cnp:3ds": {
                        "href": "https://api-gateway.sandbox.ngenius-payments.com/transactions/outlets/670bfc06-63d6-472b-af75-ad0207ac44f5/orders/cac88045-bec0-432a-8fdd-06902da874d2/payments/b0d21130-f683-442a-b7b3-397461374cdf/card/3ds"
                    },
                    "curies": [
                        {
                            "name": "cnp",
                            "href": "https://api-gateway.sandbox.ngenius-payments.com/docs/rels/{rel}",
                            "templated": true
                        }
                    ]
                },
                "reference": "b0d21130-f683-442a-b7b3-397461374cdf",
                "paymentMethod": {
                    "expiry": "2029-04",
                    "cardholderName": "John Brown",
                    "name": "VISA",
                    "pan": "411111******1111"
                },
                "state": "AWAIT_3DS",
                "amount": {
                    "currencyCode": "SAR",
                    "value": 12345
                },
                "updateDateTime": "2025-04-15T08:25:10.757199051Z",
                "outletId": "670bfc06-63d6-472b-af75-ad0207ac44f5",
                "orderReference": "cac88045-bec0-432a-8fdd-06902da874d2",
                "originIp": "196.5.8.18",
                "3ds2": {
                    "messageVersion": "2.1.0",
                    "threeDSMethodURL": "https://paypage-uat.ngenius-payments.com/fake/3ds2/method",
                    "threeDSServerTransID": "da6802ce-15cd-4631-9238-b81b0a08a6aa",
                    "directoryServerID": "M000000004"
                },
                "mid": "10089865858"
            }
        ]
    }
}
```