Your Razorpay account id.

string Identifies the sub-merchant id that granted the authorisation.

sub-merchant account status webhooks.

API key

Subscribe to webhook events to receive real-time notifications about the merchant account activation status.

You can retrieve a merchant's account onboarding status

Check your

Ensure that you enter the refresh token.

Error

The authorization_code does not contain the correct redirect_uri

Ensure that the authorization_code contains the correct redirect_uri .

The authorization_code is not provided.

A production client is using test mode

Provide the client_id .

A server error occurred while serving this error.

Error

4

We recommend subscribing to the account.app.authorization_revoked webhook event. This ensures that you receive real-time notifications whenever a sub-merchant revokes access to your connected application

acc_BFQ7uQEaa7j2z7

Sub-merchants can revoke access to your application using the Razorpay Dashboard at any time. This can cause user experience issues. We recommend you to subscribe to the webhook event - account.app.authorization_revoked to receive notification when a sub-merchant revokes access to a connected application.

Subscribe to Account Access Revoke Webhook Event (Optional)

Subscribe to Account Access Revoke Webhook Event

account.activated_kyc_pendingSample Payloadaccount.funds_holdSample Payloadaccount.funds_unholdSample Payloadaccount.activated_kyc_pendingSample Payloadaccount.instantly_activatedSample Payloadaccount.payments_enabledSample Payload

BouVWhEiuKOvfc

platform/account

flow

Payment Gateway

Orders

Recurring Payments for Partners

Recurring Payments for Partners

Using a Registration Link

Create an Authorization

Create an Order

Create a Custome

1. Create Authorisation TransactionCreate an authorisation transaction for UPI with TPV using Razorpay APIs.You can create an authorisation transaction using: Razorpay APIs Registration Link 1.1 Razorpay APIs 1.1.1. Create a Customer Razorpay links recurring tokens to customers via a unique identifier. You can generate this identifier using the Customer API. You can create customers with basic information such as email and contact and use them for various Razorpay offerings. The following endpoint creates a customer.

A registration link should always have an order amount (in paise) the customer will be charged when making the authorisation payment. This amount should be ₹1 in the case of UPI.

For UPI, it may take between 24-36 hours for the subsequent payment to reflect on your Dashboard. This is because of the failure of pre-debit notification and/or any retries that we attempt for the payment. Do not create another subsequent payment until you get the status of the previous one. For UPI, do not create subsequent payments on the last day of the cycle. This will cause the payment to fail.

Dashboard

Orders AP

1.1 Using Razorpay

Razorpay

Given below is a diagram which explains the different states the account moves to during its lifecycle:

normal

With this feature:

If they breach this limit, the status changes to needs_clarification, based on the details previously submitted.

Razorpay reviews the details and releases the funds if everything is found to be in order.

The sub-merchant needs to submit the relevant details.

PG Product Status

Alerts and Webhooks🔗

Alerts

6. Subscribe to Webhooks

You can use the Webhooks APIs to receive event notifications or subscribe to events happening in a sub-merchant's account, such as payments, orders, invoices and so on.

webhook events relevant to partners to

However, they are all optional. They are provided for the partner to proactively collect documents before the product activation status changes to under_review.

through the normal flow using the Onboarding APIs.

If they breach this limit, the status changes to under_review or needs_clarification, based on the details previously submitted.

(if GST is verified: ₹5,00,000; if GST not present: ₹50,000)

Business Email, Business Type, Business Category, Business Sub-Category, Business Name, Stakeholder Name, Stakeholder Email, Contact Mobile, Business Registered Address

Business Email, Business Type, Business Category, Business Sub-Category, Business Name, Stakeholder Name, Stakeholder Email, Contact Mobile, Business Registered Address, Owner PAN / Signatory PAN, Bank Account (IFSC Code, A/C No., Beneficiary Name), Business PAN (Optional), GST (Mandatory only if account is in 'Needs Clarification' state.)

Sign in to your Partner Dashboard to obtain your client_id and client_secret to authenticate API calls. You can obtain client_id and client_secret depending on the test mode or live mode.

The sub-merchants will need to submit documents only after they breach a specific transaction volume limit (if GST is verified: ₹5,00,000; if GST not present: ₹50,000). The funds will be on hold till the documents are submitted.

vendors and others.

Razorpay Route is a product that enables you as a partner to split payments received using the Razorpay Payment Gateway or other products and transfer the funds to sellers, third-party logistics service providers, vendors and others.

Given below is a diagram that briefly explains how Razorpay simplifies the payment split process, when handling multiple parties:

sub-merchants

Use our Linked Account APIs to create linked accounts for sellers, yourself and the third-party logistics service provider.

Disburse the payments using our Transfers APIs.

Have complete control over settlements using Settlements APIs.

Please raise a request with our Support team to get this feature activated on your Razorpay account.

As a partner, you can enable sellers to onboard as linked accounts, accept customer payments using Razorpay product suite and disburse payments using Route.

Marketplace Model - Onboard Sellers as Linked Accounts and Disburse Funds Using Razorpay Route

The following endpoint creates a Linked Account.

Linked Account Entity🔗

Marketplace

```curl: Curl curl -u [CLIENT_ID]:[CLIENT_SECRET] -X POST https://api.razorpay.com/v1/subscriptions/sub_00000000000001 \ -H "Content-Type: application/json" -H "X-Razorpay-Account: acc_Ef7ArAsdU5t0XL"

Fetch Transfers for a Settlement

Refund Payments and Reverse Transfer from a Linked Account🔗

Transfers🔗

You can use the following endpoint to modify the settlement configuration for a particular transfer_id. On a successful request, the API responds with the modified transfer entity.

Modify Settlement Hold for Transfers

fails

order

captured

aand