Initiate

This executes payout transactions across different currency pairs.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
🖐️

Prerequisite

Before calling this endpoint, you must have:

  • A valid rateId: Generated within the last 300 seconds from the Rate endpoint.
  • Payment Metadata: The specific requirements (e.g., beneficiaryAccountNumber, SortCode) for the beneficiary currency.
  • Supporting Documents: If the requireFileUpload flag was true in the requirements check, ensure the document has been uploaded and you have the SupportingDocumentReference.

📘

Understanding the Reference Prefix

To prevent duplicate references across different merchants, Leatherback automatically appends a prefix derived from your business entity name to your provided reference.

  • Your Input: SWIFTTEST
  • System Output: ays-SWIFTTEST (where ays is the merchant-specific prefix)


INR (India) Transfer Purpose Codes

When initiating a payout to India (INR), regulatory authorities require a specific Purpose Code to be included in your request. This code categorizes the nature of the remittance for compliance and monitoring by the central bank.

Include the relevant code (e.g., PC15) within the transferPurpose field inside the metaData object of your request.

CodePurpose CategoryDetailed Description
PC01Non-resident CreditCredit to Non-resident (External) Rupee accounts maintained by Non-resident Indians.
PC02Family MaintenancePayments to families of Non-resident Indians (NRIs).
PC03Investments (Insurance/MF)Payments to Insurance companies, Mutual Funds, and Postmasters for premium investments.
PC04Banking InvestmentsPayments to bankers for investments in shares and debentures.
PC05Real EstateAcquisition of residential flats in India (Housing Societies/Govt. Housing Schemes).
PC06EducationTuition, boarding, and examination fees for schools and colleges.
PC07MedicalPayments to medical institutions and hospitals for medical treatment of NRIs or dependents.
PC08HospitalityPayments to hotels for stays by NRIs or nationals of Gulf countries.
PC09TravelPayments to travel agents for booking of passages of NRIs and families.
PC10Trade (Under 15L)Trade transactions up to Rs. 15 lakhs per transaction.
PC11UtilitiesPayments for water, electricity, telephone, internet, and television.
PC12TaxesTax payments within India.
PC13Loan Repayment (EMI)EMI payments to Banks and NBFCs for repayment of loans.
PC14Relief FundRemittances directly credited to the Prime Minister's National Relief Fund.
PC15SalaryMonthly salary or wage payments to employees.
PC16Trade (Alternate)Alternate code for trade transactions up to Rs. 15 lakhs per transaction.

📘

Transaction Limits

Codes PC10 and PC16 are restricted to transactions up to Rs. 15 lakhs. For business-to-business trade payments exceeding this amount, additional supporting documentation (such as an invoice) may be required.

Body Params
string
required

This is a unique ID that "locks in" the currency conversion price for a short window.

string
required

A unique string you create to track this transaction.

string
required

Tells the API how to send the money.

string
required

The ISO3 code of the currency you are sending from

float
required

The transaction amount to be sent.

string
required

A short narration or reason for the payment.

string

Reference to an uploaded compliance document

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json