Market specifications

Do you want to know more information about India's market? Go to the India’s economy and eCommerce market article.

`country` code	`currency` code	`amount` decimals	`beneficiary.document.type` name	`beneficiary.document.id` format
`IN`	`INR`	2	PAN	10 characters (5 letters, 4 numbers, 1 letter) Full PAN validation

Mandatory parameters

Bank transfers

Bank transfer parameters	B2C	B2B	P2P
`external_id`	Yes	Yes	Yes
`payment_method_id`	Yes	Yes	Yes
`flow_type`	Yes	Yes	Yes
`purpose`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`beneficiary.first_name`	Yes	-	Yes
`beneficiary.last_name`	Yes	-	Yes
`beneficiary.business_name`	-	Yes	-
`beneficiary.email`	Yes	Yes	Yes
`beneficiary.phone`	Yes	Yes	Yes
`beneficiary.address.street`	Yes	Yes	Yes
`beneficiary.bank_account.code`	Yes	Yes	Yes
`beneficiary.bank_account.branch`	Yes	Yes	Yes
`beneficiary.bank_account.account`	Yes	Yes	Yes
`remitter.first_name`	-	-	Yes
`remitter.last_name`	-	-	Yes
`remitter.birth_info.date`	-	-	Yes
`remitter.nationality`	-	-	Yes
`remitter.document.id`	-	-	Yes
`remitter.document.type`	-	-	Yes
`remitter.address.street`	-	-	Yes
`remitter.address.city`	-	-	Yes
`remitter.address.country`	-	-	Yes

If you're a PSP integrating to our service in addition to the required information for each flow described above we require sub_merchant.business_name to be sent at the request's root level.

If you're a PSP willing to process B2B flow, please make sure to share the invoice number of the transaction in the extra_info parameter as a JSON object.
Eg: extra_info": "{\"invoice_number\":\"1234567890\"}"

UPI

UPI parameters	B2C	B2B	P2P
`external_id`	Yes	Yes	Yes
`payment_method_id`	Yes	Yes	Yes
`flow_type`	Yes	Yes	Yes
`purpose`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`beneficiary.first_name`	Yes	-	Yes
`beneficiary.last_name`	Yes	-	Yes
`beneficiary.business_name`	-	Yes	-
`beneficiary.email`	Yes	Yes	Yes
`beneficiary.phone`	Yes	Yes	Yes
`beneficiary.address.street`	Yes	Yes	Yes
`beneficiary.instant_payment.type`	Yes	Yes	Yes
`beneficiary.instant_payment.id`	Yes	Yes	Yes
`remitter.first_name`	-	-	Yes
`remitter.last_name`	-	-	Yes
`remitter.birth_info.date`	-	-	Yes
`remitter.nationality`	-	-	Yes
`remitter.document.id`	-	-	Yes
`remitter.document.type`	-	-	Yes
`remitter.address.street`	-	-	Yes
`remitter.address.city`	-	-	Yes
`remitter.address.country`	-	-	Yes

If you're a PSP integrating to our service in addition to the required information for each flow described above we require sub_merchant.business_name to be sent at the request's root level.

If you're a PSP willing to process B2B flow, please make sure to share the invoice number of the transaction in the extra_info parameter as a JSON object.
Eg: extra_info": "{\"invoice_number\":\"1234567890\"}"

Payment methods

India supports payouts via Bank Transfers and UPI. Each method requires specific parameters and follows validation rules aligned with local compliance and banking standards.

Use UPI for instant payments via a virtual payment address. Use Bank transfers when sending funds directly to a bank account.

Bank Transfers

Bank Transfers in India require detailed account information, including bank code (if not IFSC), bank branch (IFSC), bank account, amount, address, email, and phone. The format of these fields depends on the receiving bank, and strict validation rules apply.

Refer to the bank branch validation and bank codes sections for format specifications.

Mandatory parameters

All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.

Mandatory parameter	Description
`external_id`	Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method identifier. For bank transfers, use `BANK_TRANSFER`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person).
`purpose`	Payout purpose code. See purpose codes reference.
`country`	Country code. For India, use `IN`.
`amount`	Source currency of the FX operation. Use up to 2 decimal numbers.
`currency`	Payout currency. For India, use `INR` or `USD`.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Only applies when the beneficiary is an individual. Maximum 50 characters.
`beneficiary.business_name`	Beneficiary's business name. Mandatory only for B2B.
`beneficiary.email`	Beneficiary's email. 100 characters.
`beneficiary.phone`	Beneficiary's phone number. Maximum 20 characters.
`beneficiary.address.street`	Beneficiary's address street. 200 characters.
`beneficiary.bank_account.code`	Beneficiary's bank account code. See bank codes below. Mandatory if `beneficiary.bank_account.branch` does not contain an IFSC code.
`beneficiary.bank_account.branch`	Beneficiary's bank account branch. See bank branch validation below.
`beneficiary.bank_account.account`	Beneficiary's bank account number. Maximum 45 characters.
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.birth_info.date`	Remitter's birthdate. Format: `YYYY-MM-DD`. Mandatory only for remittance (P2P).
`remitter.nationality`	Remitter's nationality. ISO 3166-1 alpha-2 code. Mandatory only for remittance (P2P).
`remitter.document.id`	Remitter's document. Maximum 45 characters. Mandatory only for remittance (P2P).
`remitter.document.type`	Remitter's document type: `ID` for national identification number, `PASS` for passport. Mandatory only for remittance (P2P).
`remitter.address.street`	Remitter's address street. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter.address.city`	Remitter's address city. Maximum 40 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	Remitter's address country. ISO 3166-1 alpha-2 code. Mandatory only for remittance (P2P).

Example request

{
  "external_id": "1234567812345678b",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "IN",
  "amount": 2064,
  "currency": "INR",
  "beneficiary": {
    "first_name": "Rudrah",
    "last_name": "Hashimi",
    "email": "[email protected]",
    "phone": "+91123456789",
    "address": {
      "street": "Kailash Colony Market, HS-10"
    },
    "bank_account": {
      "branch": "SBIN0007440",
      "account": "12345678912"
    }
  }
}

{
  "external_id": "1234567812345678c",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "P2P",
  "purpose": "REMITTANCES",
  "country": "IN",
  "amount": 2064,
  "currency": "INR",
  "beneficiary": {
    "first_name": "Rudrah",
    "last_name": "Hashimi",
    "email": "[email protected]",
    "phone": "+91123456789",
    "address": {
      "street": "Kailash Colony Market, HS-10"
    },
    "bank_account": {
      "branch": "SBIN0007440",
      "account": "12345678912"
    }
  },
  "remitter": {
    "first_name": "Ashley",
    "last_name": "Peterson",
    "birth_info": {
      "date": "1986-04-25"
    },
    "nationality": "US",
    "document": {
      "type": "PASS",
      "id": "AB1234567"
    },
    "address": {
      "street": "5th Avenue 123",
      "city": "New York",
      "country": "US"
    }
  }
}

UPI

UPI (Unified Payments Interface) is an instant real-time payment system developed by the National Payments Corporation of India (NPCI). It allows users to link multiple bank accounts into a single mobile application and make transactions via a virtual payment address (VPA).

Mandatory parameters

The table below outlines the required parameters for UPI transfers.

Mandatory parameter	Description
`external_id`	Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method identifier. For UPI transfers, use `INSTANT_PAYMENT`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person).
`purpose`	Payout purpose code. See purpose codes reference.
`country`	Country code. For India, use `IN`.
`amount`	Source currency of the FX operation. Use up to 2 decimal numbers.
`currency`	Payout currency. For India, use `INR` or `USD`.
`beneficiary.first_name`	First name of the beneficiary. Maximum 50 characters.
`beneficiary.last_name`	Last name of the beneficiary. Maximum 50 characters.
`beneficiary.business_name`	Beneficiary's business name. Mandatory only for B2B.
`beneficiary.email`	Email address. Maximum 100 characters.
`beneficiary.phone`	Phone number of the beneficiary. Maximum 20 characters.
`beneficiary.address.street`	Full address. Maximum 200 characters.
`beneficiary.instant_payment.id`	UPI addres here in format [email protected]. Maximum 45 characters.
`beneficiary.instant_payment.type`	Beneficiary's instant payment account type. Fixed value: `UPI`.
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.birth_info.date`	Remitter's birthdate. Format: `YYYY-MM-DD`. Mandatory only for remittance (P2P).
`remitter.nationality`	Remitter's nationality. ISO 3166-1 alpha-2 code. Mandatory only for remittance (P2P).
`remitter.document.id`	Remitter's document. Maximum 45 characters. Mandatory only for remittance (P2P).
`remitter.document.type`	Remitter's document type: `ID` for national identification number, `PASS` for passport. Mandatory only for remittance (P2P).
`remitter.address`	Remitter address information. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter.address.city`	Remitter's address city. Maximum 40 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	Remitter's address country. ISO 3166-1 alpha-2 code. Mandatory only for remittance (P2P).

Example request

{
  "external_id": "1234567812345678d",
  "payment_method_id": "INSTANT_PAYMENT",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "IN",
  "amount": 204,
  "currency": "INR",
  "beneficiary": {
    "first_name": "Rudrah",
    "last_name": "Hashimi",
    "email": "[email protected]",
    "phone": "+91123456789",
    "address": {
      "street": "Kailash Colony Market, HS-10"
    },
    "instant_payment": {
      "type": "UPI",
      "id": "abc@defg"
    }
  }
}

{
  "external_id": "1234567812345678e",
  "payment_method_id": "INSTANT_PAYMENT",
  "flow_type": "P2P",
  "purpose": "REMITTANCES",
  "country": "IN",
  "amount": 204,
  "currency": "INR",
  "beneficiary": {
    "first_name": "Rudrah",
    "last_name": "Hashimi",
    "email": "[email protected]",
    "phone": "+91123456789",
    "address": {
      "street": "Kailash Colony Market, HS-10"
    },
    "instant_payment": {
      "type": "UPI",
      "id": "abc@defg"
    }
  },
  "remitter": {
    "first_name": "Ashley",
    "last_name": "Peterson",
    "birth_info": {
      "date": "1986-04-25"
    },
    "nationality": "US",
    "document": {
      "type": "PASS",
      "id": "AB1234567"
    },
    "address": {
      "street": "5th Avenue 123",
      "city": "New York",
      "country": "US"
    }
  }
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in India.

Bank branch validation

Name	Type	Length	Format	Details	Verification digit	Validation	Example
IFSC	Alphanumeric	11	AAAA0XXXXXX	A -> alphabetic 0 -> Zero X -> Alphanumeric	No	Validated through the list of valid IFSCs published by the RTGS and the NEFT	INDB0000018

Bank codes

We support all banks regulated by the Reserve Bank of India (RBI).

Bank Name	Bank Code
Abhyudaya Coop Bank	001
The Royal Bank of Scotland	002
Abu Dhabi Commercial Bank	003
The Akola District Central Cooperative Bank	004
Airtel Payments Bank Limited	005
Akola Janata Commercial Cooperative Bank	006
Allahabad Bank	007
The Ahmedabad Merc Coop Bank	008
Australia & New Zealand Bank	010
The Andhra Pradesh State Coop Bank	011
Andhra Pragati Grameen Bank	012
The A.P. Mahesh Co-Op Urban Bank	013
Apna Sahakari Bank Ltd.	014
Almora Urban Co-Operative Bank Ltd.	015
Bassein Catholic Co-Op Bank	016
Bank of Baroda	017
Barclays Bank	018
Bank of Bahrein & Kuwait	019
The Bharat Cooperative Bank	020
Bank of Ceylon	021
Bandhan Bank Limited	022
Dena Bank	023
Bank of India	024
Bharatiya Mahila Bank Limited	025
B N Paribas Bank	026
Bank of America	027
Bank of Tokyo-Mitsubishi	028
Central Bank of India	029
Citizen Credit Coop Bank	030
JP Morgan Chase Bank	031
Citi Bank	032
City Union Bank	033
Capital Local Area Bank Ltd.	034
Canara Bank	035
Corporation Bank	036
The Cosmos Co-Op. Bank	037
Credit Suisse Ag?	038
Credit Agricole Corp N Invsmnt Bk	039
Chhatrapati Rajarshishahu Coop Bank	040
Catholic Syrian Bank	041
Commonwealth Bk of Australia	042
Chinatrust Commercial Bank	043
Development Bank of Singapore	044
Development Credit Bank	045
Deogiri Nagari Sahakari Bank Ltd. Aurangabad	046
Deutsche Bank	047
DICGC	048
The Delhi State Cooperative Bank Limited	049
Dhanalaxmi Bank	050
Dombivli Nagari Sahakari Bank Ltd.	051
Doha Bank Qsc	052
Export Import Bank of India	053
Equitas Small Finance Bank Limited	054
The Federal Bank	055
Firstrand Bank	056
The Greater Bombay Co-Op. Bank Ltd.	057
The Gadchiroli District Central Cooperative Bank Limited	058
Gurgaon Gramin Bank Ltd.	059
The Gujarat State Co-Operative Bank	060
The Hasti Coop Bank Ltd.	061
HDFC Bank Ltd.	062
Himachal Pradesh State Cooperative Bank Ltd.	063
Hong Kong & Shanghai Bank	064
Woori	065
PT Bank Maybank Indonesia TBK	066
IDBI Bank	067
Industrial Bank of Korea	068
Industrial And Commercial Bank of China Limited	069
ICICI Bank Ltd.	070
IDFC Bank Limited	071
Indian Bank	072
Idukki District Co Operative Bank Ltd.	073
Indus-Ind Bank	074
Indian Overseas Bank	075
The Jammu & Kashmir Bank	076
Janseva Shahkari Bank Ltd. Pune	077
Janaseva Sahakari Bank Borivli Limited	078
Jalgaon Janata Sahakari	079
The Jalgaon Peopels Cooperative Bank Limited	080
Jankalyan Shakari Bank	081
Janata Sahakari Bank Ltd. (Pune)	082
The Kangra Central Cooperative Bank	083
Kallappanna Awade Ich Janata S	084
The Kangra Cooperative Bank Ltd.	085
Karnataka Bank	086
Kapole Bank	087
The Kalupur Comm Coop Bank	088
The Kalyan Janata Sahakari Bank	089
Kotak Mahindra Bank	090
Kerala Gramin Bank	091
The Kurmanchal Nagar Sahakari Bank Limited	092
The Karnataka State Coop Apex Bank	093
Keb Hana Bank	094
The Karad Urban Coop Bank Ltd.	095
Karur Vysya Bank	096
Karnataka Gramin Vikas Bank	097
The Lakshmi Vilas Bank	098
Bank of Maharashtra	099
Maharashtra Gramin Bank	100
Mahanagar Coop Bank	101
Mumbai District Central Co-Op Bank	102
Mizuho Corporate Bank Ltd.	103
Maharashtra State Cooperative Bank	104
Mashreq Bank	105
The Mehsana Urban Cooperative Bank	106
The Municipal Co Operative Bank Ltd.	107
National Australia Bank Limited	108
National Bank of Abu Dhabi PJSC	109
Nagpur Nagrik (Nnsb Ltd.*)	110
New India Co-Operative Bank	111
NKGSB Bank	112
The Nasik Merchants Co-Op Bank Ltd.	113
North Malbar Gramin Bank	114
Nutan Nagarik Sahakari Bank	115
The Bank of Nova Scotia	116
The Nainital Bank Ltd.	117
Nagar Urban Co Operative Bank	118
Oman International Bank	119
Parsik Janata Sahakari Bank	121
Pragathi Krishna Gramin Bank	122
Punjab And Maharashtra Co-Op Bank	123
Prime Co Operative Bank Ltd.	124
Prathama Bank	125
Punjab And Sind Bank	126
The Pandharpur Urban Co Op. Bank Ltd. Pandharpur	127
Punjab National Bank	128
Rabobank International (CCRB)	129
The Ratnakar Bank	130
Reserve Bank of India	131
Rajkot Nagarik Sahakari Bank Ltd.	132
Rajgurunagar Sahakari Bank Limited	133
The Rajasthan State Co-Op Bank	134
Sberbank	135
Sahebrao Deshmukh Cooperative Bank Limited	136
State Bank of Hyderabad	138
State Bank of India	139
State Bank of Mysore	140
Samarth Sahakari Bank Ltd.	141
State Bank of Travancore	142
Standard Chartered Bank	143
The Surat District Co-Op Ban	144
Shinhan Bank	145
Shikshak Sahakari Bank Limited	146
South Indian Bank	147
Solapur Janata Sahakari Bank Limited	148
Sumitomo Mitsui Banking Corporation	149
Shivalik Mercantile Co Operative Bank Ltd.	150
Societe Generale	151
The Surat People's Co-Op Bank	152
The Saraswat Co-Operative Bank	153
State Bank of Patiala	154
State Bank of Mauritius	155
Surat National Cooperative Bank Limited	156
The Sutex Cooperative Bank	157
The Seva Vikas Cooperative Bank Limited	158
The Shamrao Vithal Coop Bank	159
Syndicate Bank	160
Thane Bharat Sahakari Bank Ltd.	161
The Thane District Central Cooperative Bank Limited	162
Tumkur Grain Merchants Co-Op Bank	163
The Thane Janata Sahakari Bank	164
Tamilnadu Merc. Bank	165
The Tamildadu State Apex Coop Bank	166
Union Bank of India	167
UBS AG	168
UCO Bank	169
United Overseas Bank Limited	170
United Bank of India	171
Axis Bank	172
The Varachha Co-Op. Bank Ltd.	173
Vijaya Bank	174
The Vishweshwar Sahakari Bank Ltd.	175
Vasai Vikas Sahakari Bank	176
Ing Vysya Bank	177
The West Bengal State Co-Op Bank	178
Westpac Banking Corporation	179
Yes Bank	180
The Zoroastrian Cooperative Bank Limited	181
Zila Sahakri Bank Limited Ghaziabad	182
Paytm Payments Bank Ltd.	183
Slice small finance bank	213