This guide will walk through the end to end requirements and flow to develop the APIs required to facilitate the transaction between consumer and provider.
...
Do you need assistance in building the buyer or seller apps? Go through ONDC reference buyer and seller apps source code to help you get started.
ONDC reference Buyer APP:
...
ONDC reference Seller APP:
...
API Specifications
ONDC API contracts map business requirements for various use case scenarios to a set of attribute keys in different APIs and ensures interoperability, between a buyer app & seller app, as follows:
by defining the set of attribute keys that need to be exchanged to establish a handshake between the buyer app & seller app;
clearly defining the single source of truth for each attribute key and thereby establishing mutability & immutability of these keys on behalf of the participants at each end of the transaction;
- Retail
Retail Domains live in ONDC:
Grocery | ONDC:RET10 |
F&B | ONDC:RET11 |
Fashion | ONDC:RET12 |
Beauty & Personal Care | ONDC:RET13 |
Electronics | ONDC:RET14 |
Home & Decor | ONDC:RET15 |
Pharma | ONDC:RET16 |
...
Refer to the complete API specs and try the APIs in swagger hub:
...
Please refer our API contract to understand the attributes usage and retail specific use cases implemented. These API contracts will help you understand the single source of truth for each attribute key and thereby establishing mutability & immutability of these keys on behalf of the participants at each end of the transaction.
...
Retail B2C transaction contract between Retail Buyer and Seller:
...
- Logistics
Refer to the logistics API contract to understand the attributes usage and retail specific use cases implemented. These API contracts will help you understand the single source of truth for each attribute key and thereby establishing mutability & immutability of these keys on behalf of the participants at each end of the transaction.
...
There is a new version released for Logistics, which is currently being developed by the existing network participants in staging and pre-prod environment. All the new network participants are expected to develop on the newer version v1.2.0.
...
Logistics transaction contract between Logistics Provider and Consumer:
...
- B2B
Please refer our API contract to understand the attributes usage and retail specific use cases implemented. These API contracts will help you understand the single source of truth for each attribute key and thereby establishing mutability & immutability of these keys on behalf of the participants at each end of the transaction.
...
- Gift Card
The API contract here elaborates the process flows for buying gift cards on the network across four phases of order processing flow of discovery of gift cards available on the network, order placement, fulfillment of the order and post fulfillment requirements.
...
- Mobility
Shreyansh Shah to update
- Financial Serivices
Shreyansh Shah to update
| Tip |
|---|
IGM |
The Issue & Grievance Management (IGM) for ONDC is a mechanism via which issues between users of the network are resolved. The IGM flow has been developed based on the Issue & Grievance Management framework which acts as a facilitator to resolve issues, grievances and disputes between a Complainant and Respondent in a manner that ensures transparency, fairness and data security to the parties. The framework is built on the interactions on a tripartite Network Participants (NPs) contract for a unique transaction including logistics services by Logistics Service Provider (LSP) that has been procured on-network. This implies that a complainant shall be raising an issue for a particular transaction on the network which may involve buyer app, seller app, logistics service provider app or any other participants as may be notified by ONDC as identified entities for a given transaction.
| View file | ||||
|---|---|---|---|---|
|
Try the APIs on swagger hub:
...
Refer to IGM API contract here:
...
| Tip |
|---|
RSP (Reconciliation and Settlement) |
...
The objective is to propose a Reconciliation and Settlementframework for Network Participants (NP), such as Buyer Platforms, Seller Platforms, Logistics Platform etc, on ONDC. The construct defined will provide a framework for participants to settle funds against transactions to respective parties and create an audit trail of transactions. Following are the enumerated design principles for reconciliation and settlement framework:
...
| View file | ||||
|---|---|---|---|---|
|
Try the APIs on swagger hub:
...
Refer to RSP API contract here:
...
| Panel | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
Serviceability |
...
The objective is to propose process flows for Cancellation, Return & Replacement. Cancellation, Return & Replacement can be processed by Buyer & Seller Apps, using existing protocol APIs. The detailed process flows and sequence diagrams are defined below.
This note proposes detailed process flows for the following:
Cancellation - for the full order or for part of an order, i.e. some of the items in an order;
Return - for one or more items in an order. A part return will be defined as return of one or more items in an order but not return of all items in the order. A full return will be defined as the return of all items in the order.
Replacement- for one or more items in an order. A part replacement will be defined as replacement of one or more items in an order but not replacement of all items in the order. A full replacement will be defined as the replacement of all items in the order. Note that a replacement can also be handled by part or full return of the order and creating a new order with the items that are being partly or fully replaced.
...