Rista Integration User Guide: Seamless Sync with ONDC through PaiPai

Created by Surya Boddu, Modified on Mon, 1 Apr, 2024 at 5:36 PM by Surya Boddu

PaiPai has simplified the process for businesses, regardless of their size, to seamlessly integrate with Rista, one of the world's largest e-commerce platforms. Thanks to this collaboration, Rista users can effortlessly link up with the Open Network for Digital Commerce (ONDC) via PaiPai, enabling them to start selling on ONDC with ease. This partnership serves as a seamless bridge that empowers Rista businesses to broaden their online presence.

Within their Rista accounts, users can easily configure various aspects such as products, product groups, categories, and outlets. Furthermore, the integration provides the capability to utilize Webhooks for customizing different operations within their Rista accounts, including Order Updates, Product Updates, and Inventory Updates.

As a result of this integration, any modifications made within the Rista account will be promptly synchronized with the PaiPai system, which, in turn, will update the corresponding ONDC listings accordingly.

1.1 Requirements

For you to proceed with the Integration, certain requirements must be met.

  1. You must have your Rista Account already created. If you haven’t please complete your Account Creation.

  2. You must have your PaiPai Account already created. If you haven’t please complete your Account Creation.

  3. Step-by-Step Process for Rista Integration

Step 1: Create a PaiPai Account from System Side

To integrate with Rista, the business needs to be registered with PaiPai. To create an account through the sales lead, you can follow the steps in this guide.

Once the Account is created, move on to the next step.

Step 2: Go to the Accounts Module on the Left-Side Panel and Click on Accounts


You will be able to access the list of the accounts created on the PaiPai system.


Step 3: Click on the Tenant ID of the Account that you want to Integrate with Rista

Step 4: You will See the General info of the Account. Click on The Edit Button

Step 5: In the Details Panel, Select the Upstream Provider as Rista from Dropdown

Update the Settings and move on to the next step.

Step 6: Get the auth and URL details from the client


Get the following details from the client:

secret_key
api_key
branch code

channel

Note: construct a JSON with the details given by the client and configure it in out custom header section

EX: { "api_key": "5e976dc4-2fe2-4dc7-bc65-196bdee5b60e", "secret_key": "wdNBIwp9a-9CQeFV2rVRNQcPTuT0srDL5Szk9CsUa0w"}3

Step 7: Generate BKC code from PaiPai Account

Navigate to the Accounts Module and go to Generate API tokens.

Click on Create New.

Select Type as PaiPai Upstream API from the dropdown. Select Upstream Provider as Rista. Select the Account Name. Give the API key a name and description.

Once entering all the details, click on the Create Button.

The generated API key will be shown in the table. 

Click on the ID to access the details. 

Under the details, you can find the PaiPai Key Checksum at the bottom. 




Step 8: Configure the End Points and Custom Headers

Go to the General Info Tab and enter the Order Push Endpoint, Order Status Push Endpoint, Rider Push Endpoint and Customer Headers in their respective fields. You can find the format of how these configurations should be made in the table below.

Configuration 

Format

Order Push End Point

https://api.ristaapps.com/v1/sale

Order Status Push End Point

https://api.ristaapps.com/v1/sale/status

Rider Status Push End Point

https://api.ristaapps.com/v1/sale/delivery/status

Custom Headers

 {"api_key": "<client api key>", "secret_key": "<client secret key>,"channel": "PaiPai","bkc": "PaiPai BKC code"}


Custom header format

{"api_key": "9b19048e-7d0f-4e20-9615-cc703b6ead31", "secret_key": "0H1B6Sfh1XAW6txmP7xR8aXGiLjUzP-lyDqQeHMfe28", "channel": "PaiPai","bkc": "5edea9e5f683eef869642568996dab59"}


Step 9: Synchronize the Catalog

Once the configuration is done in the Rista account, you can synchronize it automatically with your PaiPai system.

Go to the General Info Tab of the Account and on the top right corner, you can see the Actions Dropdown

You can go to the Upstream Events to verify the status of your Initial catalog Setup and other activities as well.


To access this go to Upstream module and click on Events.

Once the Setup is done, the items from the Rista Catalog will reflect on the PaiPai System

Along with the Outlets 

Step 10: Set up the Business category on the Account Side

Go to Business Profile and Click on the Edit button in the Top-Right Corner

In the General Info, Select the Business Category from the drop-down


Step 11 Configure the Taxonomy

On the System side, go to the Accounts Module→ Accounts and select Rista Account that we configured.

Go to the G Taxonomy Tab and C Taxonomy Tab respectively and configure with required details

Step 12 Configuring for ONDC

  • Go to ONDC Module on the Left-side Panel

  • Click on Accounts

You will see the list of all the Accounts

  • Click on Add to ONDC Button on the top-right Corner

You will see a pop-up screen with entry fields

  • Enter the Details

  • Click on Add Button

The Account will be added to the ONDC and you can see it in the list of Accounts

  • Click on the Account to see the general info of the Account

  • Click on the Outlets tab

  • Map the Outlet


  • Now Click on the Items tab


  • Click on the Actions Dropdown and select Map all

The account is added to ONDC, and all the products and outlets are synced.



Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article