← Back to Account Payouts docs
← Back to Parties docs

India

Domestic Payment (real-time)

Overview

Available	Yes
`targetCurrency`	Indian Rupee (INR)
`countryCode`	IN
Earliest Beneficiary Credit	real-time
Cut-Off Time (UK Time)	N/A
Decimal Places	2
Minimum `targetAmount`	1
Maximum `targetAmount`	1500000 (For trade transactions)

Required data

API field name	Required?	Field length	Description
`purposeOfPayment.description`	✅	6	The code that represents the purpose of the payment. See Additional data for the full list of accepted values.
`transactionType`	✅	4	Type of transaction Available values: `customerToCustomer` `businessToBusiness` `government` `reversal` `return` `customerToBusiness` `businessToCustomer`
`beneficiaryBankDetails.accountNumber`	✅	6-20	Account number of the beneficiary. Important If the beneficiary details are of the HDFC Bank, then the max length of the account number should be exactly 14 digits.
`beneficiaryBankDetails.bankCode`	✅	11	Indian Financial System Code must be 11 digits in length IFSC code consists of 11 digits. First 4 represent bank code, fifth character is 0 and the remaining 6 characters identify the branch e.g. HDFC0000XXX.
`beneficiaryBankDetails.bankName`	✅	Max 35	Name of the beneficiary bank.
`parties.partyType`	✅	4	Type of the party. Must be: `beneficiary`
`parties.personalDetails.type`	✅	4	Entity description code for the party. Available values: `company` `person` `soleTrader` `institution` `government`
`parties.personalDetails.title`	Conditional	4	Title code for the Individual. Available values: `ms` `mrs` `mr` `dr` `mx` `misc` Condition Mandatory if `parties.personalDetails.type` is: `person`
`parties.personalDetails.firstName`	Conditional	Max 50	Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if `parties.personalDetails.type` is: `person`
`parties.personalDetails.middleName`	❌	Max 50	Beneficiary middle name.
`parties.personalDetails.lastName`	Conditional	Max 50	Beneficiary last name. Condition Mandatory if `parties.personalDetails.type` is: `person`
`parties.personalDetails.companyName`	Conditional	Max 140	Full name of the organization. Important Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager. Condition Mandatory if `parties.personalDetails.type` is: `company` `institution` `government` `other`
`parties.personalDetails.dateOfBirth`	❌	10	Beneficiary's date of birth in YYYY-MM-DD format.
`parties.personalDetails.dateOfIncorporation`	❌	10	A `company`s date of incorporation in YYYY-MM-DD format.
`parties.identityDocuments.type`	Conditional	4	Type code specific for invoice documentation Must be: `other` Condition You must give all of the conditional identity fields, if you provide at least one of the properties.
`parties.identityDocuments.number`	Conditional	9	Invoice number. Condition Mandatory for trade transactions.
`parties.identityDocuments.issuingCountry`	Conditional	2	Country code of the invoice Enter the 2 character ISO 3166-1 standard country code in your API request. Condition Mandatory for trade transactions.
`parties.identityDocuments.validFrom`	Conditional	10	Issue date of the Invoice in YYYY-MM-DD format. Condition Mandatory for trade transactions.
`parties.address.address1`	❌	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street.
`parties.address.address2`	❌	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
`parties.address.city`	❌	Max 35	Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
`parties.address.postalCode`	❌	Max 10	Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
`parties.address.countryCode`	❌	2	Beneficiary's country code of their residential (if payee is an individual) or registered (if payee is a company) address. Enter the 2 character ISO 3166-1 standard country code in your API request.
`parties.address.residentialStatus`	✅	4	Beneficiary's residential status. Available values: `resident` `nonResident` `other`

Important

We do not support Trade transactions sent to HDFC bank.

Important

Additional data is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).

International WIRE

Overview

Available	Yes
`targetCurrency`	Available WIRE currencies
`countryCode`	IN
Earliest Beneficiary Credit	The estimated delivery time will vary by country and currency.
Cut-Off Time (UK Time)	Currency specific
Decimal Places	2
Minimum `targetAmount`	1
Maximum `targetAmount`	9999999.99

Required data

API field name	Required?	Field length	Description
`beneficiaryBankDetails.accountNumber`	✅	Max 35	Account number of the beneficiary.
`beneficiaryBankDetails.bankCode`	❌	Max 35	Bank code of the beneficiary (bank).
`beneficiaryBankDetails.branchCode`	❌	Max 35	Branch code of the beneficiary (bank).
`beneficiaryBankDetails.swiftBic`	✅	8 or 11	The SWIFT BIC is the Bank Identification Code of the beneficiary bank.
`beneficiaryBankDetails.bankName`	✅	Max 35	Name of the beneficiary bank.
`parties.partyType`	✅	4	Type of the party. Must be: `beneficiary`
`parties.personalDetails.type`	✅	4	Entity description code for the party. Available values: `company` `person` `soleTrader` `institution` `government`
`parties.personalDetails.title`	Conditional	4	Title code for the Individual. Available values: `ms` `mrs` `mr` `dr` `mx` `misc` Condition Mandatory if `parties.personalDetails.type` is: `person`
`parties.personalDetails.firstName`	Conditional	Max 50	Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if `parties.personalDetails.type` is: `person`
`parties.personalDetails.middleName`	❌	Max 50	Beneficiary middle name.
`parties.personalDetails.lastName`	Conditional	Max 50	Beneficiary last name. Condition Mandatory if `parties.personalDetails.type` is: `person`
`parties.personalDetails.companyName`	Conditional	Max 140	Full name of the organization. Important Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager. Condition Mandatory if `parties.personalDetails.type` is: `company` `institution` `government` `other`
`parties.personalDetails.dateOfBirth`	❌	10	Beneficiary's date of birth in YYYY-MM-DD format.
`parties.personalDetails.dateOfIncorporation`	❌	10	A `company`s date of incorporation in YYYY-MM-DD format.
`parties.address.address1`	❌	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street.
`parties.address.address2`	❌	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
`parties.address.city`	❌	Max 35	Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
`parties.address.postalCode`	❌	Max 10	Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
`parties.address.countryCode`	Conditional	2	Beneficiary's country code of their residential (if payee is an individual) or registered (if payee is a company) address. Condition Mandatory if any of the optional Beneficiary address details are provided. Enter the 2 character ISO 3166-1 standard country code in your API request.

Important

Additional data is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).

India

Domestic Payment (real-time)

Overview

Required data

International WIRE

Overview

Required data

Do you like our page?