08 - Send response to order changes initiated by Seller App - ACK to /on_update
Developing
POST
/on_update
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/on_update' \
--header 'Content-Type: application/json' \
--data-raw '{
"context": {
"domain": "ONDC:RET11",
"country": "IND",
"city": "std:0124",
"core_version": "1.2.5",
"action": "on_update",
"transaction_id": "{{transaction_id}}",
"message_id": "{{message_id}}",
"timestamp": "{{timestamp}}",
"bap_uri": "{{bap_uri}}",
"bap_id": "{{bap_id}}",
"ttl": "PT30S"
},
"message": {
"order": {
"id": "SS1747978302628",
"state": "Completed",
"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": "68f21c45-e77f-429b-9952-2b217d8a7b58"
},
{
"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": "68f21c45-e77f-429b-9952-2b217d8a7b58"
},
{
"id": "id_1cctu3_9_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": "68f21c45-e77f-429b-9952-2b217d8a7b58"
}
],
"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-23T05:31:36.029Z",
"updated_at": "2025-05-23T05:31:36.029Z"
},
"fulfillments": [
{
"id": "68f21c45-e77f-429b-9952-2b217d8a7b58",
"@ondc/org/provider_name": "Pramaan Store 1",
"@ondc/org/category": "Immediate Delivery",
"@ondc/org/TAT": "PT24H",
"state": {
"descriptor": {
"code": "Order-delivered"
}
},
"type": "Delivery",
"tracking": true,
"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-23T05:31:42.646Z",
"end": "2025-05-23T23:00:00.000Z"
},
"timestamp": "2025-05-23T05:32:39.334Z"
},
"contact": {
"phone": "9876543210",
"email": "ss_seller_1@ss.com"
}
},
"end": {
"location": {
"gps": "28.4554726,77.0219019",
"address": {
"name": "Nirdosh Chauhan",
"building": "221 B",
"locality": "Baker Steeet",
"city": "Gurgaon",
"state": "Haryana",
"country": "India",
"area_code": "122007"
}
},
"contact": {
"phone": "9876543210",
"email": "nirdosh.chauhan@sequelstring.com"
},
"person": {
"name": "Nirdosh Chauhan"
},
"time": {
"range": {
"start": "2025-05-24T09:30:00.000Z",
"end": "2025-05-24T19:00:00.000Z"
},
"timestamp": "2025-05-23T05:32:51.403Z"
}
},
"tags": [
{
"code": "routing",
"list": [
{
"code": "type",
"value": "P2P"
}
]
},
{
"code": "tracking",
"list": [
{
"code": "gps_enabled",
"value": "yes"
},
{
"code": "url_enabled",
"value": "yes"
},
{
"code": "url",
"value": "https://ondc.sequelstring.com/track/68f21c45-e77f-429b-9952-2b217d8a7b58"
}
]
}
]
},
{
"@ondc/org/provider_name": "Pramaan Store 1",
"type": "Return",
"state": {
"descriptor": {
"code": "Return_Initiated"
}
},
"tags": [
{
"code": "return_request",
"list": [
{
"code": "id",
"value": "bcef07ab-c158-44f1-b619-9d362428ddb2"
},
{
"code": "item_id",
"value": "id_ancc5_0_0"
},
{
"code": "item_quantity",
"value": "2"
},
{
"code": "reason_id",
"value": "003"
},
{
"code": "reason_desc",
"value": "some detailed reason for return"
},
{
"code": "images",
"value": "https://some-images-for-item.com"
},
{
"code": "ttl_approval",
"value": "PT24H"
},
{
"code": "ttl_reverseqc",
"value": "P3D"
},
{
"code": "parent_item_id",
"value": "P3121"
}
]
},
{
"code": "return_request",
"list": [
{
"code": "id",
"value": "5100b016-13b8-4ce2-9f1a-d75d623fa82a"
},
{
"code": "item_id",
"value": "id_5yzai_2_0"
},
{
"code": "item_quantity",
"value": "2"
},
{
"code": "reason_id",
"value": "003"
},
{
"code": "reason_desc",
"value": "some detailed reason for return"
},
{
"code": "images",
"value": "https://some-images-for-item.com"
},
{
"code": "ttl_approval",
"value": "PT24H"
},
{
"code": "ttl_reverseqc",
"value": "P3D"
},
{
"code": "parent_item_id",
"value": "P3121"
}
]
}
],
"id": "bcef07ab-c158-44f1-b619-9d362428ddb2"
}
],
"quote": {
"price": {
"currency": "INR",
"value": "1375.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": "id_1cctu3_9_0",
"title": "Double Patty Cheese Burger",
"@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": "CG41"
}
]
},
{
"code": "np_fees",
"list": [
{
"code": "channel_margin_type",
"value": "percent"
},
{
"code": "channel_margin_value",
"value": "0.50"
}
]
}
]
}
},
{
"@ondc/org/item_id": "68f21c45-e77f-429b-9952-2b217d8a7b58",
"title": "Delivery charges",
"@ondc/org/title_type": "delivery",
"price": {
"currency": "INR",
"value": "40"
}
},
{
"@ondc/org/item_id": "68f21c45-e77f-429b-9952-2b217d8a7b58",
"title": "Tax",
"@ondc/org/title_type": "tax",
"price": {
"currency": "INR",
"value": "5"
},
"item": {
"tags": [
{
"code": "quote",
"list": [
{
"code": "type",
"value": "fulfillment"
},
{
"code": "subtype",
"value": "delivery"
}
]
}
]
}
},
{
"@ondc/org/item_id": "68f21c45-e77f-429b-9952-2b217d8a7b58",
"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"
}
]
}
]
}
},
{
"@ondc/org/item_id": "68f21c45-e77f-429b-9952-2b217d8a7b58",
"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"
}
]
}
]
}
}
]
},
"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": "1375.00",
"currency": "INR",
"transaction_id": "f16ee2c5-bf2e-403c-b4a0-54145dde6a09"
},
"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-23T05:31:42.628Z",
"updated_at": "2025-05-23T05:33:56.453Z",
"documents": [
{
"label": "Invoice",
"url": "https://ondc.sequelstring.com/seller/document/invoice.pdf"
}
]
}
}
}'Response Response Example
{}Request
Body Params application/json