04 - Finalize order with Seller App (confirmation of order) subject to ACK from Seller App - /confirm
Developing
POST
/confirm
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/confirm' \
--header 'Content-Type: application/json' \
--data-raw '{
"context": {
"domain": "ONDC:RET11",
"country": "IND",
"city": "std:0124",
"core_version": "1.2.5",
"action": "confirm",
"transaction_id": "{{transaction_id}}",
"message_id": "{{message_id}}",
"timestamp": "{{timestamp}}",
"bap_uri": "{{bap_uri}}",
"bap_id": "{{bap_id}}",
"ttl": "PT30S"
},
"message": {
"order": {
"id": "SS1748931122971",
"state": "Created",
"provider": {
"id": "pramaan_provider_1",
"locations": [
{
"id": "SSL1"
}
]
},
"items": [
{
"id": "id_ancc5_0_0",
"location_id": "SSL1",
"quantity": {
"count": 2
},
"parent_item_id": "P3121",
"tags": [
{
"code": "type",
"list": [
{
"code": "type",
"value": "item"
}
]
}
],
"fulfillment_id": "7ce4af7f-b505-4dd2-8e35-180c857daec6"
},
{
"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": "7ce4af7f-b505-4dd2-8e35-180c857daec6"
}
],
"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-06-03T06:11:53.586Z",
"updated_at": "2025-06-03T06:11:53.586Z"
},
"fulfillments": [
{
"id": "7ce4af7f-b505-4dd2-8e35-180c857daec6",
"type": "Delivery",
"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"
}
},
"tracking": true,
"@ondc/org/TAT": "PT24H"
}
],
"quote": {
"price": {
"currency": "INR",
"value": "277.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"
}
]
},
{
"code": "timing",
"list": [
{
"code": "day_from",
"value": "1"
},
{
"code": "day_to",
"value": "5"
},
{
"code": "time_from",
"value": "1800"
},
{
"code": "time_to",
"value": "2200"
}
]
}
]
}
},
{
"@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": "7ce4af7f-b505-4dd2-8e35-180c857daec6",
"title": "Delivery charges",
"@ondc/org/title_type": "delivery",
"price": {
"currency": "INR",
"value": "40"
}
},
{
"@ondc/org/item_id": "7ce4af7f-b505-4dd2-8e35-180c857daec6",
"title": "Tax",
"@ondc/org/title_type": "tax",
"price": {
"currency": "INR",
"value": "5"
},
"item": {
"tags": [
{
"code": "quote",
"list": [
{
"code": "type",
"value": "fulfillment"
}
]
}
]
}
},
{
"@ondc/org/item_id": "flat150",
"title": "Min value offer applied",
"@ondc/org/title_type": "offer",
"price": {
"currency": "INR",
"value": "-150"
},
"item": {
"tags": [
{
"code": "quote",
"list": [
{
"code": "type",
"value": "order"
}
]
},
{
"code": "offer",
"list": [
{
"code": "type",
"value": "discount"
},
{
"code": "additive",
"value": "yes"
},
{
"code": "auto",
"value": "yes"
}
]
}
]
}
},
{
"@ondc/org/item_id": "buy2get3",
"@ondc/org/item_quantity": {
"count": "1"
},
"title": "Item count offer applied",
"@ondc/org/title_type": "offer",
"price": {
"currency": "INR",
"value": "0.00"
},
"item": {
"tags": [
{
"code": "quote",
"list": [
{
"code": "type",
"value": "order"
}
]
},
{
"code": "offer",
"list": [
{
"code": "type",
"value": "buyXgetY"
},
{
"code": "additive",
"value": "no"
},
{
"code": "auto",
"value": "yes"
},
{
"code": "item_count",
"value": "1"
},
{
"code": "item_id",
"value": "I2"
},
{
"code": "item_value",
"value": "0.00"
}
]
}
]
}
},
{
"@ondc/org/item_id": "freebie1",
"@ondc/org/item_quantity": {
"count": "1"
},
"title": "Item count offer applied",
"@ondc/org/title_type": "offer",
"price": {
"currency": "INR",
"value": "0.00"
},
"item": {
"tags": [
{
"code": "quote",
"list": [
{
"code": "type",
"value": "order"
}
]
},
{
"code": "offer",
"list": [
{
"code": "type",
"value": "freebie"
},
{
"code": "additive",
"value": "no"
},
{
"code": "auto",
"value": "yes"
},
{
"code": "item_count",
"value": "1"
},
{
"code": "item_id",
"value": "I4"
}
]
}
]
}
}
]
},
"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"
}
]
}
],
"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": "277.00",
"currency": "INR",
"transaction_id": "1e1ac440-2008-4ebe-b43a-e49b472e5a06"
},
"type": "ON-ORDER",
"status": "PAID"
},
"created_at": "2025-06-03T06:12:02.971Z",
"updated_at": "2025-06-03T06:12:02.971Z"
}
}
}'Response Response Example
{}Request
Body Params application/json