Integration

Guide
1
Introduction

The following guide is designed to support you through your ONDC

Integration Journey.
It contains:
1
Network Participant
Journey
The process of integrating with the ONDC protocol and becoming a Network
Participant

2
Instructions on navigating the ONDC portal

ONDC portal is the single point for managing your integration and coordinating with
ONDC for closing any open requirements; this guide will enable you to get started on
the portal 2
Network Participant Journey
1 2 3 4 5

Sign up on Explore Select Role Integration Go-Live

ONDC Portal Webinars & Domain

Integrate with
Attend ONDC APIs and
Create a profile
introductory Use the portal test your Qualify the
on the ONDC
briefings and to select your solution on our requirements
portal and
stay connected role and build environments – and Go-Live on
explore our
on regular for your Staging, Pre- the ONDC
introductory
community configuration Production and network
resources
webinars Production

3
Network Participant Journey
1 2 3 4 5

Sign up on Explore Select Role Integration Go-Live

ONDC Portal Webinars & Domain

Integrate with
Attend ONDC APIs and
Create a profile
introductory Use the portal test your Qualify the
on the ONDC
briefings and to select your solution on our requirements
portal and
stay connected role and build environments – and Go-Live on
explore our
on regular for your Staging, Pre- the ONDC
introductory
community configuration Production and network
resources
webinars Production

4
Step 1: Sign Up on the ONDC Portal
Sign up to the ONDC Portal to create your profile on ONDC and learn about next steps

ONDC Portal

The Portal is crucial in helping ONDC Team understand your business profile and
support you on the next steps accordingly

You can find all necessary resources, raise queries and track your progress on the ONDC
portal

5
ONDC Portal | Sign up

1 Sign up on the ONDC Portal on behalf of your

organisation

e-KYC will be required for the registration following

2 which you can set your password

Note – This profile if for your organisation, please

register on behalf of your team. You will be able to
add more users going forward.

3 Go over the ONDC portal user guide

6
ONDC Portal | Keeping your profile updated

Please provide further

details of your
organization to enable
the ONDC team to
support you better

4
You can add
representative users
at this stage

7
Network Participant Journey
1 2 3 4 5

Sign up on Explore Select Role Integration Go-Live

ONDC Portal Webinars & Domain

Integrate with
Attend ONDC APIs and
Create a profile
introductory Use the portal test your Qualify the
on the ONDC
briefings and to select your solution on our requirements
portal and
stay connected role and build environments – and Go-Live on
explore our
on regular for your Staging, Pre- the ONDC
introductory
community configuration Production and network
resources
webinars Production

8
Step 2: Explore Webinars

Business Technical Implementatio Registry

Briefing Briefing n Briefing Onboarding
ONDC
Webinars
Tuesday Friday Monday Daily
3 – 4 PM 11 AM – 12 PM 3 – 4 PM 10 – 10.45 AM

What is the How to join the

technology that How to join ONDC staging
What is ONDC?
powers ONDC? ONDC? environment?

9
Introduction to ONDC | What is ONDC and how does it work?
Your ONDC journey begins with the following briefings and resources:
Business Briefing Call Technology Briefing Introductory
Call Resources
In this call the team will: Provide you with an 1. ONDC Strategy Paper
1. Walk you through the overview of: 2. Website
basics of ONDC 1. APIs for Integration 3. ONDC Business Briefin
2. Provide a value 2. Resources available for g Presentation
proposition for entities Integration on Github 4. ONDC Technical Briefin
3. Call Details: and Swaggerhub g Presentation
Tuesday 3:00 - 4:00 PM 3. Call Details: 5. ONDC Building Trust
Meeting link Friday 11:00 – 12:00 PM 6. McKinsey
Meeting link Industry Report

Please sign up on the ONDC Portal if you haven’t done so already

An accurate understanding of ONDC is essential in helping you pick your role in the
10
network
Implementation Briefing & Registry Onboarding | How do I join ONDC?

To understand the steps to integrate with ONDC or how to register on an ONDC enabled
application, join the Implementation Briefing. Here are the relevant resources:

Implementation Plan Briefing Call

Monday 3:00 - 4:00 PM, Implementation Plan Briefing Deck

Meeting Link
Registry Onboarding Call

Daily 10:00 - 10:45 AM,

Meeting Link

• An entity can create a personalized ONDC implementation journey on

the ONDC portal basis role and domain selected
• This will provide you with the latest requirements and steps to be completed
• All participants are requested to track their integration progress on the ONDC
portal to get your queries resolved and stay aligned with the ONDC team 11
ONDC Academy | A utility to guide your team to understand ONDC better

Aspiring NPs can now learn the best practices to establish and grow an e-commerce
business on ONDC Academy. Along with learning modules, an assessment-based
certification has been developed along with NSE Academy.

This certification is given for validating the users knowledge of handling digital commerce
operations. (Passing score 80%).

ONDC Academ ONDC Academy Youtube Channel

y

ONDC will recognise such Seller NPs who have at least 2 of their employees certified as a
"ONDC ACADEMY CERTIFIED SELLER NETWORK PARTICIPANT"

NPs are required to fill the form for the employees receiving the certificate for ONDC Team to
validate and officially recognise the certified Seller NPs.

ONDC Academy -Seller NP Certificat

ion 12
ONDC Portal | Discover Community Webinars & Academy

Your team can explore and sign up for ONDC community webinars on the Portal Home

13
ONDC Portal | Community Webinars

14
Network Participant Journey
1 2 3 4 5

Sign up on Explore Select Role Integration Go-Live

ONDC Portal Webinars & Domain

Integrate with
Attend ONDC APIs and
Create a profile
introductory Use the portal test your Qualify the
on the ONDC
briefings and to select your solution on our requirements
portal and
stay connected role and build environments – and Go-Live on
explore our
on regular for your Staging, Pre- the ONDC
introductory
community configuration Production and network
resources
webinars Production

15
Step 3: Select Role and Domain
An entity can play various roles on ONDC, the primary roles* are:
Seller Node Buyer Node Technology Service
Provider
1. Marketplace Seller Buyer Node - Any entity Any entity that enables
Node - Any entity that that enables any buyer to either a seller node or a
enables third party search for and buy products buyer node on ONDC by
merchants / service or services on the ONDC providing a software
providers to sell their network application (either stand
products on the ONDC alone or through cloud)
Network
2. Inventory Seller Node
– Any entity that will act as
a “seller on record” on
Network Participants includes Seller side and Buyer side nodes, TSPs are not Network
ONDC selling from their own
Participants.
You can use the following documents to help you determine your role on the network:
inventory
Network Participant A Regulatory Requireme Taxation Obligations
greement nts for NPs for NPs

*Note – We recommend that you review the Network Agreement for legal definitions of these16
Domains | What are Domains and how do they differ from categories?

To understand ONDC and how it expands, it is important to distinguish between Domains

and Categories on the Network
Domains Categories

● At ONDC, Domains can be ● Category constitutes products that

distinguished by the way have similar market or usage
products/services are bought and sold characteristics. Some examples are:
(Ex. Retail, Logistics, Financial Retail domain (Categories: Grocery,
Services, Mobility & Travel etc.) F&B, Consumer Electronics. etc)
● Domain enablement usually merits a Financial Services domain
major protocol modifications whereas (Categories: Credit, Insurance, Gift
new category introduction in a Cards etc)
domain doesn't
● An entity can play the role of a Buyer
node or Seller node or both in each
domain. (Ex. A Seller node in the 17
Retail domain can act as a Buyer
Configuration
A configuration is a combination of role, domain and protocol version. Each configuration will
be mapped to a distinct integration journey

Role Domain/ Category Version

Buyer Retail Protocol Version 1.2

1
Application

2 Seller Retail Protocol Version 1.2

Application

3 Buyer B2B Protocol Version 1.1

Application

Each of the above is a distinct integration journey with its own set of requirements, each will
be tracked distinctly on the ONDC portal

18
ONDC Portal | Selecting your role on the ONDC portal

Your organization may select

one or more roles to proceed
with integration

Note – Your organization may

decide to integrate as more
than one role. Please
remember, each role will
lead to a different
configuration and thus a
different integration journey

19
ONDC Portal | Measuring profile completion

You must complete your profile

before you can start integration

Indicates percentage of
profile completion

Indicates pending fields

against each category

20
ONDC Portal | Starting your integration

Note - Only once your profile is complete you can

start integration for a specific configuration

21
ONDC Portal | Configuration Example - Seller NP (MSN) – Retail – v1.20

Use the drop downs to select appropriate responses and

select Add

Proceed to move to next step – managing your 22

integrations
ONDC Portal | Tracking configuration integration process

● On the Configurations list you will be able to create a plan and track the status against the
same
● You can create and work on more than one configuration at a time

23
Network Participant Journey
1 2 3 4 5

Sign up on Explore Select Role Integration Go-Live

ONDC Portal Webinars & Domain

Integrate with
Attend ONDC APIs and
Create a profile
introductory Use the portal test your Qualify the
on the ONDC
briefings and to select your solution on our requirements
portal and
stay connected role and build environments – and Go-Live on
explore our
on regular for your Staging, Pre- the ONDC
introductory
community configuration Production and network
resources
webinars Production

24
Step 4: Integration
ONDC integration refers to the API integration with the ONDC protocols + building the
operations and complying with relevant policy for conducting transactions on the network

Integration takes place over three

environments:
Production
Staging Pre-Prod
(Restricted to live
(Free access to all for early- (Limited access based on
applications for real-time
stage development) approval of demo app)
transactions)
Requirements are spread across the following functions:

Operational
Policy Tech Growth
Readiness

25
 Integration Cont.
The ONDC portal maps the integration requirements as per the following summary,
exhaustive requirements can be found on the portal once you start integrating for a
configuration.
Environments provided by ONDC for API integration and network-based
transactions
Staging Pre-Prod Production
(Free access to all for (Limited access based (Restricted to live
early-stage on approval of demo applications for real-
development) app) time transactions)

Policy
Requirements to
Tech proceed to Pre-
Requirements to proceed Qualification of
Production are verified
Function to Production will have to probationary testing and
s
Operation on basis of a demo with
be submitted on the growth metrics tracking
al the ONDC team which
Portal for approval
can be scheduled on the
Readiness
Portal
Growth
26
ONDC Portal | Overview on Portal

Define timelines and create a

plan

Select submit to provide your timelines and comply to revert to track requirements at different
stages
27
ONDC Portal | Planning the Integration

To track open items against each and define

timelines (Refer to next slide)

Select confirm and proceed to track requirements at different

stages – Staging, Pre-Production and Production

28
ONDC Portal | Join Staging

The instructions on accessing the staging environment can be found on the ONDC portal,
the subscriber code can be submitted online for approval

29
ONDC Portal | Completing the requirements (Ex – Pre-Production)

Navigatio
n
You must complete requirements across all
stages

These indicate open requirements across functions. In this case, to obtain approval for move to
production, your team must comply with the requirements for Pre-Prod on the ONDC Portal
30
Network Participant Journey

1 2 3 4 5

Sign up on Explore Select Role Integration Go-Live

ONDC Portal Webinars & Domain

Integrate with
Attend ONDC APIs and
Create a profile
introductory Use the portal test your Qualify the
on the ONDC
briefings and to select your solution on our requirements
portal and
stay connected role and build environments – and Go-Live on
explore our
on regular for your Staging, Pre- the ONDC
introductory
community configuration Production and network
resources
webinars Production

31
Step 5: Go-Live
Successfully surpassing the threshold for functional testing, complying with the final
checklist and successfully navigating the Probationary Period on Production environment
qualifies an NP to Go-Live on Production. This means that an NP can start their e-commerce
operations on ONDC along with the existing ecosystem of Network Participants.

In case of an ONDC Protocol Update, these updates will first be tested on Pre-Production and
then launched on Production environment.

Applications live on ONDC

Please refer to the following link to view the list of Network Participants and Ecosystem
Participants live on the network:

ONDC Participants

32