Upgraded docs version is here ✨

Your documentation experience is getting an upgrade. Check it out now!

Go To Beta

Docs upgrade is here. Check it out!

Go To Beta
API ReferenceIntegrationsKnowledge Base

Transfer Payments Received Using Payment Links

Using Razorpay Payment Links, you can transfer the payments received from your customers automatically to your linked accounts. You no longer need to create a separate transfer using Razorpay Route Transfers API. Instead, you can use the order parameter in Create Payment Links API to automate the transfer once the payment is received from the customer.

Prerequisite🔗

You must have created and onboarded linked accounts using Razorpay Route, via the Dashboard. Learn more about Razorpay Route.

Note:

  • You cannot create transfers on a Payment Link which has accept_partial parameter enabled. Ensure that this parameter is set to false. Also, do not pass the first_min_partial_amount parameter.
  • You cannot create transfers on a Payment Link created using an international currency. Currently, transfers are only supported on Payment Links created using INR.

Request Parameters🔗

You can automate transfers to linked accounts, using Payment Links. Pass the following parameters along with the Create Payment Link API request.

options mandatory

array Options to configure the transfer in the Payment Link. Parent parameter under which the order child parameter must be passed.

order mandatory

array The parameter under which the linked account and transfer details must be configured to perform the transfer. transfer is a child parameter of order.

transfers

array Pass transfer details such as amount, account, linked account information and more.

account mandatory
string Unique identifier of the linked account to which the transfer is to be made.
amount mandatory
integer The amount to be transferred to the linked account. For example, for an amount of ₹200.35, the value of this field should be 20035. This amount cannot exceed the order amount.
currency mandatory
string The currency in which the transfer should be made. We support only INR for Route transactions.
notes
json object Set of key-value pairs that can be associated with an entity. This can be useful for storing additional information about the entity. A maximum of 15 key-value pairs, each of 256 characters (maximum), are supported. For example, "region": "south", "city": "bangalore".
linked_account_notes
array List of keys from the notes object which needs to be shown to linked accounts on their Dashboard. For example, "region", "city". Only the keys will be shown, not values.
on_hold optional
boolean Indicates whether settlements to the linked account should be put on hold. Possible values:
  • true - Puts the settlement on hold.
  • false - Releases the settlement.
on_hold_until optional
integer Timestamp, in Unix, that indicates until when the settlement of the transfer must be put on hold. If no value is passed, the settlement is put on hold indefinitely.
×