Home›ONDC Transaction›Create Order

Create Order

Step 3 of the ONDC order flow. Creates the order and initiates the payment process. Must use the same transactionId from select and init.

Create Order

POST/ret11/orders/create-order

Auth Required

Include a Bearer token. See Authentication.

Request Body

Field	Type	Required	Description
device	string	required	Device type. Values: `"WEB"` \| `"MOBILE"` \| `"APP"`
transactionId	string	required	Same UUID used in select and init
pg	string	required	Payment gateway. Currently: `"RAZORPAY"`
userId	string	required	Your own platform's user ID for the logged-in user (from your user management system)
mobile	string	required	User's mobile number

Request Example

{
  "device": "WEB",
  "transactionId": "123f090-48b9-a9c5-6db5be6621dh",
  "pg": "RAZORPAY",
  "userId": "8f3a1c2e-9b4a-4e7c-b6d3-9a8f1e2d3c45",
  "mobile": "9876543210"
}

Response

Field	Type	Description
orderId	string	Internal order ID. Save this for all subsequent order operations (track, status, cancel, rate, IGM).
paymentOrderId	string	Payment gateway order reference (e.g., `HDFOOD0000000128`)
pg	string	Payment gateway used
orderStatus	string	Initial status: `"INITIATED"`
transaction_id	string	The transaction ID (echoed back)

Response Example

{
  "data": {
    "orderId": "019d1476113e75598fa4d0389075cef0",
    "paymentOrderId": "HDFOOD0000000128",
    "pg": "RAZORPAY",
    "orderStatus": "INITIATED",
    "transaction_id": "123f090-48b9-a9c5-6db5be6621dh"
  }
}

Payment Flow

After receiving the orderId, redirect the user to the payment gateway to complete payment. Once payment is done, call GET /ret11/orders/{orderId} to confirm payment success before showing a success screen.

Post-Payment Flow

Call POST /ret11/orders/create-order → get orderId
Redirect user to payment gateway using paymentOrderId
After payment callback/redirect, call GET /ret11/orders/{orderId}
If paymentOrderStatus === "SUCCESS", show order confirmation
Use orderId for all future operations: track, status, cancel