Process Platform and Third-Party Fees

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 -X POST https://api.razorpay.com/v1/orders \
-H 'X-Razorpay-Account: acc_KBrJAIEqre5ucn' \
-H 'Authorization: Bearer <YOUR_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": 1,
      "notes": {
        "account": "3PL Account"
      },
      "linked_account_notes": [
        "account"
      ]
    },
    {
      "account": "acc_KD09wcp6WYoLkC",
      "amount": 50000,
      "currency": "INR",
      "on_hold": 1,
      "notes": {
        "account": "Swiggy 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.

Create Transfers from Orders

Set Up Webhooks

Related Information