05 - Retrieve the latest status of an order from the Seller App - /on_status
Developing
POST
/on_status
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/on_status' \
--header 'Content-Type: application/json' \
--data-raw '{
"context": {
"domain": "ONDC:RET11",
"country": "IND",
"city": "std:0124",
"core_version": "1.2.5",
"action": "on_status",
"transaction_id": "{{transaction_id}}",
"message_id": "{{message_id}}",
"timestamp": "{{timestamp}}",
"bap_uri": "{{bap_uri}}",
"bap_id": "{{bap_id}}",
"ttl": "PT30S"
},
"message": {
"order": {
"id": "SS1747985714991",
"state": "In-progress",
"provider": {
"id": "pramaan_provider_1",
"locations": [
{
"id": "SSL1"
}
]
},
"items": [
{
"id": "id_ancc5_0_0",
"quantity": {
"count": 2
},
"parent_item_id": "P3121",
"tags": [
{
"code": "type",
"list": [
{
"code": "type",
"value": "item"
}
]
},
{
"code": "np_fees",
"list": [
{
"code": "id",
"value": "1"
}
]
}
],
"fulfillment_id": "60e58daa-9c69-445a-8a31-ae3ef14913ab"
},
{
"id": "id_5yzai_2_0",
"quantity": {
"count": 2
},
"parent_item_id": "P3121",
"tags": [
{
"code": "type",
"list": [
{
"code": "type",
"value": "customization"
}
]
},
{
"code": "parent",
"list": [
{
"code": "id",
"value": "CG11"
},
{
"code": "default",
"value": "yes"
}
]
}
],
"fulfillment_id": "60e58daa-9c69-445a-8a31-ae3ef14913ab"
}
],
"billing": {
"address": {
"name": "Nirdosh Chauhan",
"building": "221 B",
"locality": "Baker Steeet",
"city": "Gurgaon",
"state": "Haryana",
"country": "India",
"area_code": "122007"
},
"tax_number": "00ABCDE1234F1Z5",
"name": "Nirdosh Chauhan",
"email": "nirdosh.chauhan@sequelstring.com",
"phone": "9876543210",
"created_at": "2025-05-23T07:34:52.693Z",
"updated_at": "2025-05-23T07:34:52.693Z"
},
"fulfillments": [
{
"id": "60e58daa-9c69-445a-8a31-ae3ef14913ab",
"@ondc/org/provider_name": "Pramaan Store 1",
"@ondc/org/category": "Takeaway",
"@ondc/org/TAT": "PT24H",
"state": {
"descriptor": {
"code": "Packed"
}
},
"type": "Self-Pickup",
"tracking": false,
"start": {
"location": {
"id": "SSL1",
"gps": "28.527300,77.182100",
"descriptor": {
"name": "Pramaan Store 1",
"images": [
"https://ondc.org/assets/theme/images/ondc_registered_logo.svg?v=399788fda7"
]
},
"address": {
"locality": "N. Caldwell",
"city": "New Delhi",
"area_code": "110030",
"state": "New Delhi"
}
},
"time": {
"range": {
"start": "2025-05-23T07:35:15.012Z",
"end": "2025-05-23T23:00:00.000Z"
}
},
"contact": {
"phone": "9876543210",
"email": "ss_seller_1@ss.com"
}
}
}
],
"quote": {
"price": {
"currency": "INR",
"value": "830.00"
},
"breakup": [
{
"@ondc/org/item_id": "id_ancc5_0_0",
"title": "Farmhouse Pizza",
"@ondc/org/item_quantity": {
"count": 2
},
"@ondc/org/title_type": "item",
"price": {
"currency": "INR",
"value": "530.00"
},
"item": {
"price": {
"currency": "INR",
"value": "265"
},
"parent_item_id": "P3121",
"tags": [
{
"code": "veg_nonveg",
"list": [
{
"code": "veg",
"value": "yes"
}
]
},
{
"code": "type",
"list": [
{
"code": "type",
"value": "item"
}
]
},
{
"code": "custom_group",
"list": [
{
"code": "id",
"value": "CG11"
}
]
},
{
"code": "np_fees",
"list": [
{
"code": "channel_margin_type",
"value": "percent"
},
{
"code": "channel_margin_value",
"value": "0.50"
}
]
}
]
}
},
{
"@ondc/org/item_id": "id_5yzai_2_0",
"title": "100% Wheat Thin Crust",
"@ondc/org/item_quantity": {
"count": 2
},
"@ondc/org/title_type": "item",
"price": {
"currency": "INR",
"value": "0.00"
},
"item": {
"price": {
"currency": "INR",
"value": "0"
},
"parent_item_id": "P3121",
"tags": [
{
"code": "veg_nonveg",
"list": [
{
"code": "veg",
"value": "yes"
}
]
},
{
"code": "type",
"list": [
{
"code": "type",
"value": "customization"
}
]
},
{
"code": "parent",
"list": [
{
"code": "id",
"value": "CG11"
},
{
"code": "default",
"value": "yes"
}
]
},
{
"code": "child",
"list": [
{
"code": "id",
"value": "CG21"
}
]
}
]
}
},
{
"@ondc/org/item_id": "60e58daa-9c69-445a-8a31-ae3ef14913ab",
"title": "Delivery charges",
"@ondc/org/title_type": "delivery",
"price": {
"currency": "INR",
"value": "0"
}
},
{
"@ondc/org/item_id": "60e58daa-9c69-445a-8a31-ae3ef14913ab",
"title": "Packing charges",
"@ondc/org/title_type": "packing",
"price": {
"currency": "INR",
"value": "25"
}
},
{
"@ondc/org/item_id": "60e58daa-9c69-445a-8a31-ae3ef14913ab",
"title": "Tax",
"@ondc/org/title_type": "tax",
"price": {
"currency": "INR",
"value": "5"
},
"item": {
"tags": [
{
"code": "quote",
"list": [
{
"code": "type",
"value": "item"
},
{
"code": "subtype",
"value": "misc"
}
]
},
{
"code": "np_fees",
"list": [
{
"code": "id",
"value": "1"
}
]
}
]
}
},
{
"@ondc/org/item_id": "60e58daa-9c69-445a-8a31-ae3ef14913ab",
"title": "Convenience Fee",
"@ondc/org/title_type": "misc",
"price": {
"currency": "INR",
"value": "40"
},
"item": {
"tags": [
{
"code": "quote",
"list": [
{
"code": "type",
"value": "item"
}
]
},
{
"code": "np_fees",
"list": [
{
"code": "id",
"value": "1"
},
{
"code": "channel_margin_type",
"value": "percent"
},
{
"code": "channel_margin_value",
"value": "0.50"
}
]
}
]
}
}
]
},
"payment": {
"@ondc/org/buyer_app_finder_fee_type": "percent",
"@ondc/org/buyer_app_finder_fee_amount": "3",
"@ondc/org/settlement_details": [
{
"settlement_counterparty": "seller-app",
"upi_address": "",
"beneficiary_name": "SEQUELSTRING AI",
"settlement_type": "neft",
"settlement_bank_account_no": "9876543210012",
"settlement_ifsc_code": "AXIS123456",
"settlement_phase": "sale-amount",
"settlement_status": "NOT-PAID",
"bank_name": "AXIS BANK LTD ",
"branch_name": "NAVI MUMBAI"
}
],
"collected_by": "BAP",
"@ondc/org/settlement_basis": "delivery",
"@ondc/org/settlement_window": "P1D",
"@ondc/org/withholding_amount": "10.00",
"params": {
"amount": "830.00",
"currency": "INR",
"transaction_id": "b98e21ba-27d6-4f36-9a64-7d4ecc32813f"
},
"type": "ON-ORDER",
"status": "PAID"
},
"tags": [
{
"code": "bpp_terms",
"list": [
{
"code": "np_type",
"value": "MSN"
},
{
"code": "tax_number",
"value": "00CBADE2145H1Z5"
},
{
"code": "max_liability",
"value": "2"
},
{
"code": "max_liability_cap",
"value": "10000.00"
},
{
"code": "mandatory_arbitration",
"value": "false"
},
{
"code": "court_jurisdiction",
"value": "New Delhi"
},
{
"code": "delay_interest",
"value": "7.50"
},
{
"code": "provider_tax_number",
"value": "ABCDE1234F"
}
]
},
{
"code": "bap_terms",
"list": [
{
"code": "tax_number",
"value": "00XYZAB1234C1Z8"
},
{
"code": "accept_bpp_terms",
"value": "Y"
}
]
}
],
"created_at": "2025-05-23T07:35:14.991Z",
"updated_at": "2025-05-23T07:37:38.522Z"
}
}
}'
Response Response Example
{}
Request
Body Params application/json