Skip to content
APIs/
/
/
India

← Back to BAV docs

India

Overview

AvailableYes
targetCurrencyIndian Rupee (INR)
countryCodeIN

Required data

API field nameRequired?Field lengthDescription
instructions.party.payoutInstrument.accountNumber✅6-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.
instructions.party.payoutInstrument.bankCode✅11Indian 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.
instructions.party.payoutInstrument.bankName✅Max 35Name of the beneficiary bank.
instructions.party.type✅N/AType of the party.
Must be:
  • beneficiary
instructions.party.payoutInstrument.accountType✅N/AType of the account.
Available values:
  • checking
  • savings
  • moneyMarket
  • certificateOfDeposit
  • vista
  • other
instructions.party.payoutInstrument.accountHolderNameConditionalMin 2 and Max 70Beneficiary full name. Full name should be provided (no initials).
Condition
Mandatory if instructions.party.personalDetails.type is person and instructions.party.personalDetails.firstName and/or instructions.party.personalDetails.lastName are not provided.

Or if instructions.party.personalDetails.type is company and the instructions.party.personalDetails.companyName is not provided.
instructions.party.personalDetails.type✅N/AEntity description code for the party.
Available values:
  • company
  • person
  • soleTrader
  • institution
  • government
instructions.party.personalDetails.titleConditionalN/ATitle code for the Individual.
Available values:
  • ms
  • mrs
  • mr
  • miss
  • dr
  • mx
  • misc
Condition
Mandatory if instructions.party.personalDetails.type is:
  • person
instructions.party.personalDetails.firstNameConditionalMax 35Beneficiary first name. Full name should be provided (no initials).
Condition
Mandatory if instructions.party.personalDetails.type is:
  • person
instructions.party.personalDetails.middleName❌Max 35Beneficiary middle name.
instructions.party.personalDetails.lastNameConditionalMax 35Beneficiary last name.
Condition
Full Name (First + Middle + Last name) must be between 2 and 70 characters, including spaces and any other characters.

Mandatory if instructions.party.personalDetails.type is:
  • person
instructions.party.personalDetails.companyNameConditionalMax 70Full name of the organization.
Condition
Mandatory if instructions.party.personalDetails.type is:
  • company
  • institution
  • government
  • other
instructions.party.personalDetails.dateOfBirth❌10Beneficiary's date of birth in YYYY-MM-DD format.
instructions.party.personalDetails.dateOfIncorporation❌10A company`s date of incorporation in YYYY-MM-DD format.
instructions.party.identityDocuments.typeConditionalN/AType 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.
instructions.party.identityDocuments.numberConditional9Invoice number.
Condition
Mandatory for trade transactions.
instructions.party.identityDocuments.issuingCountryConditional2Country code of the invoice
Enter the 2 character ISO 3166-1 standard country code in your API request.
Condition
Mandatory for trade transactions.
instructions.party.identityDocuments.validFromConditional10Issue date of the Invoice in YYYY-MM-DD format.
Condition
Mandatory for trade transactions.
instructions.party.address.address1❌Max 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.
instructions.party.address.address2❌Max 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
instructions.party.address.city❌Max 35Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
instructions.party.address.postalCode❌Max 10Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
instructions.party.address.countryCode✅2Beneficiary'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.
instructions.party.address.residentialStatus✅N/ABeneficiary's residential status.
Available values:
  • resident
  • nonResident
  • other