Integration Guides

ONDC Integration Guide for Sellers and D2C Brands

How ONDC works, the choice between joining through a seller app and building your own, the protocol flow, testing and what the integration demands of catalogue, orders and logistics.

Purushottam Kumar Suman
Purushottam Kumar Suman
Founder & CEO, Drema AI
8 min read
Online retail on a laptop

ONDC is not a marketplace or an app. It is an open network where any buyer app can discover and order from any seller app using a common protocol. A brand listed once becomes visible in every buyer app on the network, and can choose logistics from providers on the same network.

01

How the network is organised

The network unbundles what a marketplace does into separate roles.

Buyer appWhere customers search and order
Seller appHolds catalogues and receives orders for sellers; either a marketplace of many sellers or a single brand's own inventory
Logistics providerOffers delivery on the network
Registry and gatewayONDC's infrastructure that lists participants and broadcasts search
Technology service providerBuilds and runs the integration for a participant
02

Two ways to join

Most sellers do not need to write protocol code.

Join through a seller app first. Build your own when order volume justifies it.

Through an existing seller appUpload catalogue, connect inventory and start receiving orders in one to four weeks. You pay the seller app a fee or commission
As your own seller appBuild the protocol integration, get certified and join as a network participant. More control and lower per-order cost at scale, but months of work and ongoing protocol upgrades
03

The protocol flow

ONDC uses the Beckn protocol. Every action is an asynchronous pair: the buyer side calls an API and the seller side replies through a callback. Each message is digitally signed and verified against the registry.

search and on_searchDiscovery: the seller app returns its catalogue for the buyer's location
select and on_selectCart: item availability, quote and delivery charges
init and on_initCheckout: billing, delivery address and payment terms
confirm and on_confirmOrder creation
status, track, update, cancelFulfilment, tracking, returns and cancellation
Issue and grievance managementComplaints raised and resolved through network APIs
Reconciliation and settlementSettlement of amounts between participants
04

Building your own seller app

If you take the direct route, plan for these components.

Protocol adapterMessage signing and verificationCatalogue in ONDC taxonomyServiceability by pincodeReal-time inventoryOrder management syncLogistics search on networkIssue and grievance moduleSettlement reconciliationLog submission for certification
05

Testing and going live

Integration moves through staging, pre-production and production environments. You register on the participant portal, generate signing keys, subscribe to the registry and run the required flows for your domain, such as grocery, food and beverage or fashion. Certification involves submitting logs of each flow for verification before production access is granted. Each domain has its own mandatory attributes and scenarios.

06

What it demands operationally

Buyer apps rank and suppress sellers on fulfilment performance, so the technical integration is only half the work. Inventory must be accurate, orders accepted within the time limits, and cancellations kept low. Product data needs the attributes the network requires, including statutory details for packaged goods and food licences for food sellers.

1 to 4 weeks
To go live through an existing seller app
Async
Every API has a callback pair
Fulfilment
Performance decides visibility
Sources · last reviewed October 1, 2026

This article explains what to build, not legal advice. Rules change; confirm against the current official text before relying on it.

Purushottam Kumar Suman
Written by
Purushottam Kumar Suman
Founder & CEO, Drema AI

Founder and CEO of Drema AI. Builds AI systems, SaaS platforms and industry software — and writes about what actually survives production.

CTA Background

Got a problem like this one?

Bring it to a call with a founder.You will get a straight answer, including when the answer is no.

View Our Work
AI-First Engineering
Secure & Scalable
Built to Deliver Impact