Process Platform and Third-Party Fees

Process platform and third-party fees and transfer them to your Linked Accounts.

Available in🇮🇳 India

After setting up the platform and third-party accounts, you can deduct your platform and third-party fees from the transaction amount while creating an order. After the payment is captured and the order is paid, transfers are automatically created and settled to the respective Linked Accounts.

Create Transfers from Orders

You can transfer platform and third-party fees when creating an order using the Orders API. Pass the transfers parameters as a part of the Order API request body.

Use the access_token generated in the build integration step to authenticate using Bearer Auth.

The following endpoint lets you transfer the funds while creating an order.

POST /orders

Curl

curl -X POST https://api.razorpay.com/v1/orders \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'content-type: application/json'
-d '{
  "amount": 1000000,
  "currency": "INR",
  "transfers": [
    {
      "account": "acc_KD088uBnQf0XeK",
      "amount": 800000,
      "currency": "INR",
      "notes": {
        "account": "Seller Account"
      },
      "linked_account_notes": [
        "account"
      ]
    },
    {
      "account": "acc_KD097GTiIju5WG",
      "amount": 150000,
      "currency": "INR",
      "on_hold": true,
      "notes": {
        "account": "3PL Account"
      },
      "linked_account_notes": [
        "account"
      ]
    },
    {
      "account": "acc_KD09wcp6WYoLkC",
      "amount": 50000,
      "currency": "INR",
      "on_hold": true,
      "notes": {
        "account": "Acme Account"
      },
      "linked_account_notes": [
        "account"
      ]
    }
  ]
}'

Pass the Linked Account id of the receiver of the transfer in the account parameter under the transfers object.

• To transfer the platform fees, add the Linked Account id of your platform.
• To transfer the third-party fees, add the Linked Account id of the corresponding third party.

The parameter descriptions and errors are present in the Create Transfers from Orders documentation.

Set Up Webhooks

To receive notifications on when a transfer is processed, set up the transfer.processed webhook event. Check the sample payload for Transfer Processed.

Watch Out!

• You cannot create transfers on an order which has partial_payment parameter enabled. Ensure that this parameter is set to 0.
• You cannot create transfers on an order for international currencies. Currently, this feature is available for INR only.
• If a Transfer via Order initiated by you fails, we will retry this transfer starting from the next day on consecutive days. There will be a maximum of 3 retries.

Related Information

• Set up Platform and Third-Party Accounts
• Refunds and Reversals