Order Status
Check payment and order confirmation status. Call this endpoint after create-order to verify that payment was successful before showing a confirmation screen.
Get Order Status
GET/ret11/orders/{orderId}
Auth Required
Include a Bearer token. See Authentication.
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| orderId | path | string | required | From create-order response |
| userId | query | string | required | Your own platform's user ID for the logged-in user |
Example Request
GET /ret11/orders/019d1476113e75598fa4d0389075cef0?userId=8f3a1c2e-9b4a-4e7c-b6d3-9a8f1e2d3c45Response
| Field | Type | Description |
|---|---|---|
| paymentOrderStatus | string |
Payment status: "SUCCESS" |
"PENDING" | "FAILED" |
"INITIATED"
|
| orderState | string |
Current order state (e.g., "Accepted",
"Created")
|
| orderId | string | Order identifier |
| paymentOrderId | string | Payment gateway reference ID |
Response Example
{
"data": {
"paymentOrderStatus": "SUCCESS",
"orderState": "Accepted",
"orderId": "019bb2ca-a956-71a8-83c1-397bc5a092f9",
"paymentOrderId": "HDFOOD0000000005"
}
}Polling Strategy
Poll this endpoint after redirecting from the payment gateway. Once
paymentOrderStatus is "SUCCESS", the order
is confirmed. Use orderId for all subsequent tracking
and management operations.