Skip to main content
Use this endpoint to create a Payout Link using the Contact id of the recipient. Create a Contact to generate the Contact id/Customer id.

Request

Curl

Response

Success

Parameters

account_numbermandatory : string The account from which you want to make the payout. Account details can be found on the RazorpayX Dashboard. For example, 7878780080316316.
  • Pass your customer identifier if you want money to be deducted from RazorpayX Lite.
  • Pass your current account number if you want money to be deducted from your current account.
Watch Out!
  • This is NOT your contact’s bank account number. Log in to your RazorpayX Dashboard and go to My Account & Settings → Banking → Customer Identifier.
  • This value is different for Test Mode and Live Mode.
contactmandatory : object Details of the contact to whom the Payout Link is to be sent.idmandatory : string The unique identifer for the contact. For example, cont_00000000000001.If you are using this, do not use the other parameters in the array.amountmandatory : integer The amount, in paise, to be transferred from the business account to the contact’s fund account. For example, pass 1000000 to transfer an amount of ₹10,000. The minimum value that can be passed is 100.The value passed here does not include fees and tax. Fees and tax, if any, are deducted from your account balance.currencymandatory : string The currency in which the payout is being made. Here, it is INR.purposemandatory : string The purpose of the payout that is being created via the Payout Link. For example, refund.Classifications available by default:
  • refund
  • cashback
  • payout
  • salary
  • utility bill
  • vendor bill
Additional purposes for payouts can be created via the Dashboard and then used in the API. You cannot create new payout purposes via the API.descriptionmandatory : string Add a description to communicate the context of the Payout Link to the recipient. For example, Cashback for Mr. Gaurav Kumar on the purchase on Earl Grey Tea.receiptoptional : string A user-entered receipt number for the payout. For example, Receipt No. 1.send_smsoptional : boolean Possible values:
  • true: Razorpay sends the Payout Link to the provided contact number via SMS.
  • false (default): You send the Payout Link to the contact via SMS.
send_emailoptional : boolean Possible values:
  • true: Razorpay sends the Payout Link to the provided email address via email.
  • false (default): You send the Payout Link to the contact via email.
notesoptional : object User-entered notes for internal reference. This is a key-value pair. You can enter a maximum of 15 key-value pairs. For example, "note_key": "Beam me up Scotty”.expire_byoptional : integer Timestamp, in Unix, when the Payout Link was to expire. This is set at the time of creation of the Payout Link and is set at least 15 minutes ahead of the current time.This value is returned only if you have enabled the expiry feature for Payout Links. Know how to set expiry to Payout Links.

Parameters

id : string The unique identifier of the Payout Link that is created. For example, poutlk_00000000000001. entity : string The entity being created. Here it will be payout_link. contact : object Details of the contact to whom the Payout Link is to be sent. name : string The contact’s name. For example, Gaurav Kumar. type : string Classification of the contact being created. For example, employee. contact : string The contact’s phone number. For example, 9000090000. email : string The contact’s email address. For example, gaurav.kumar@example.com. contact_id : string The unique identifier of the contact to whom the Payout Link has to be sent. For example, cont_00000000000001. fund_account_id only if contact provides their account details : string The unique identifier of the contact’s fund account to which the payout will be made. For example, fa_00000000000001. Fund Account id is returned only when the Payout Link moves to the processing state. payout_id only if the contact receives the amount in their account : string The unique identifier for the payout made to the contact. For example, pout_00000000000001. This value is returned only when the Payout Link moves to the processed state. purpose : string The purpose of the payout. For example, refund, cashback or payout. status : string The Payout Link status. Possible values:
  • pending
  • issued
  • processing
  • processed
  • cancelled
  • rejected
Refer to the Payout Link Life Cycle section for more details. amount : integer The amount, in paise, to be transferred from the business account to the contact’s fund account. The value passed here does not include fees and tax. Fees and tax, if any, are deducted from your account balance. currency : string The currency in which the payout is being made. Here, it is INR. description : string A user-entered description for the Payout Link. For example, Payout link for Gaurav Kumar. attempt_count : integer The number of attempts to complete the payout. receipt : string A user-entered receipt number for the payout. For example, Receipt No. 1. notes : object User-entered notes for internal reference. This is a key-value pair. For example, "note_key": "Beam me up Scotty”. short_url : string A short link for the Payout Link that was created. This is the link that is shared with the contact. send_sms : boolean Possible values:
  • true: SMS sent to the provided contact number.
  • false: SMS could not be sent to the provided contact number. This could be because the contact number provided was wrong.
send_email : boolean Possible values:
  • true: Email sent to the provided email address.
  • false: Email could not be sent to the provided email address. This could be because the email address provided was wrong.
created_at : integer Timestamp, in Unix, when the Payout Link was created. cancelled_at : integer Timestamp, in Unix, when the Payout Link was cancelled by you. This value is returned only when the Payout Link moves to the cancelled state. expire_by : integer Timestamp, in Unix, when the Payout Link was to expire. This is set at the time of creation of the Payout Link and is set at least 15 minutes ahead of the current time. This value is returned only if you have enabled the expiry feature for Payout Links. Know more about how to set expiry to Payout Links. expired_at : integer Timestamp, in Unix, when the Payout Link expired. This is set at the time of creation of the Payout Link.