India

Domestic Payment (real-time)

Overview

AvailableYes
targetCurrencyIndian Rupee (INR)
countryCodeIN
Earliest Beneficiary Creditreal-time
Cut-Off Time (UK Time)N/A
Decimal Places2
Minimum targetAmount1
Maximum targetAmount1500000 (For trade transactions)

Required data

API field nameRequired?Field lengthDescription
purposeOfPaymentNarrative6The code that represents the purpose of the payment. See Additional data for the full list of accepted values.
transactionTypeCode4Type of transaction
Available values:
  • TT01 (Customer to Customer)
  • TT02 (Business to Business)
  • TT03 (Customer to Business)
  • TT04 (Business to Customer)
  • TT07 (Government to Government)
  • TT08 (Customer to Government)
  • TT09 (Business to Government)
bankDetails.beneficiaryAccountNumber6-20Account 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.
bankDetails.bankCode11Indian 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.
bankDetails.bankNameMax 35Name of the beneficiary bank.
parties.personalDetails.partyTypeCode4Type of the party.
Must be:
  • PT03 (Beneficiary)
parties.personalDetails.typeCode4Entity description code for the party.
Available values:
  • PD01 (Company)
  • PD02 (Individual)
parties.personalDetails.titleCodeConditional4Title code for the Individual.
Available values:
  • TO01 (Ms)
  • TO02 (Miss)
  • TO03 (Mr)
  • TO04 (Mrs)
  • TO05 (Dr)
  • TO06 (Mx)
  • TO99 (Misc)
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.firstNameConditionalMax 50Beneficiary first name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.middleNameMax 50Beneficiary middle name.
parties.personalDetails.lastNameConditionalMax 50Beneficiary last name.
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.companyNameConditionalMax 140Full 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.typeCode is:
  • PD01 (Company)
  • PD03 (Institution)
  • PD04 (Government)
  • PD99 (Other)
parties.personalDetails.dateOfBirth10Beneficiary's date of birth in YYYY-MM-DD format.
parties.identity.identityTypeCodeConditional4Type code specific for invoice documentation
Must be:
  • ID99

Condition
You must give all of the conditional identity fields, if you provide at least one of the properties.
parties.identity.identityNumberConditional9Invoice number.
Condition
Mandatory for trade transactions.
parties.identity.issuingCountryConditional2Country code of the invoice
Enter the 2 character ISO 3166-1 standard country code in your API request.
Condition
Mandatory for trade transactions.
parties.identity.startDateConditional10Issue date of the Invoice in YYYY-MM-DD format.
Condition
Mandatory for trade transactions.
parties.address.streetMax 35Beneficiary'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.additionalAddressLineMax 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
parties.address.cityMax 35Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.postCodeOrZipCodeMax 10Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.countryCode2Beneficiary'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.residentialStatusCode4Beneficiary's residential status.
Available values:
  • RS01 (Resident)
  • RS02 (Non Resident)
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

AvailableYes
targetCurrencyAvailable WIRE currencies
countryCodeIN
Earliest Beneficiary CreditThe estimated delivery time will vary by country and currency.
Cut-Off Time (UK Time)Currency specific
Decimal Places2
Minimum targetAmount1
Maximum targetAmount9999999.99

Required data

API field nameRequired?Field lengthDescription
bankDetails.beneficiaryAccountNumberMax 35Account number of the beneficiary.
bankDetails.bankCodeMax 35Bank code of the beneficiary (bank).
bankDetails.branchCodeMax 35Branch code of the beneficiary (bank).
bankDetails.swiftBic8 or 11The SWIFT BIC is the Bank Identification Code of the beneficiary bank.
bankDetails.bankNameMax 35Name of the beneficiary bank.
parties.personalDetails.partyTypeCode4Type of the party.
Must be:
  • PT03 (Beneficiary)
parties.personalDetails.typeCode4Entity description code for the party.
Available values:
  • PD01 (Company)
  • PD02 (Individual)
parties.personalDetails.titleCodeConditional4Title code for the Individual.
Available values:
  • TO01 (Ms)
  • TO02 (Miss)
  • TO03 (Mr)
  • TO04 (Mrs)
  • TO05 (Dr)
  • TO06 (Mx)
  • TO99 (Misc)
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.firstNameConditionalMax 50Beneficiary first name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.middleNameMax 50Beneficiary middle name.
parties.personalDetails.lastNameConditionalMax 50Beneficiary last name.
Condition
Mandatory if parties.personalDetails.typeCode is:
  • PD02 (Individual)
parties.personalDetails.companyNameConditionalMax 140Full 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.typeCode is:
  • PD01 (Company)
  • PD03 (Institution)
  • PD04 (Government)
  • PD99 (Other)
parties.personalDetails.dateOfBirth10Beneficiary's date of birth in YYYY-MM-DD format.
parties.address.streetMax 35Beneficiary'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.additionalAddressLineMax 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
parties.address.cityMax 35Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.postCodeOrZipCodeMax 10Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.countryCodeConditional2Beneficiary'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).