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.