Countries specifics

Improve your approval ratio across countries by collecting and providing additional data

When utilizing the H2H API in Solidgate, it is crucial to gather and transmit supplementary customer information to ensure successful card or alternative payment method acceptance in specific regions. This data must be included within the payment request via the payment_type_data

It’s important to focus on the Card BIN and retrieve a set of necessary supplementary fields based on the BIN country (the first 6 digits). Additionally, depending on the provider, the customer’s phone number parameter is frequently utilized to authenticate the individual initiating the payment, such as indian_customer_phone in the case of India.

Guide
Easily build a safe and simple payment page with our straightforward, step-by-step guide. Payment page or Guide
Understand how to integrate the payment form into your product. Payment form would gather any additional information on your behalf.

In the table below, you can find the fields required within specific countries and alternative payment methods.

Parameter	Type	Regular Expression	Description	Country	Method
`argentina_dni`	string	`[0-9\]{7,9}`	A national identity document code should be collected and provided for Argentinian cardholders.	Argentina	Card
`bangladesh_nic`	string	`[0-9\]{13,17}`	National Identity Card	Bangladesh	Card
`bolivia_ci`	string	`[0-9\]{5,20}`	Cedula de Identidad	Bolivia	Card
`brazil_cpf`	numeric	`[0-9\]{11}`	CPF Validation Document - Last two digits are verifiers	Brazil	Card
`cameroon_cni`	string	`[0-9\]{8}`	СNI	Cameroon	Card
`chile_ci`	string	`.{8,9}`	Rol Único Tributario	Chile	Card
`china_id`	string	`[0-9\]{5,20}`	Citizen ID Number	China	Card
`colombia_cc`	string	`[0-9\]{6,10}`	Cedula de Ciudadania	Colombia	Card
`costa_rica_ci`	string	`[0-9\]{9}`	Cédula de Identidad	Costa Rica	Card
`dominicana_id`	string	`[0-9\]{11}`	Identity card	Dominican Republic	Card
`ecuador_ci`	string	`[0-9\]{5,20}`	Cédula de Identidad	Ecuador	Card
`el_salvador_id`	string	`[0-9\]{9,11}`	Personal Identification Card	El Salvador	Card
`egypt_id`	string	`[0-9\]{14}`	Identity card	Egypt	Card
`ghana_card`	string	`[a-zA-Z0-9\]{13}`	Ghana Card	Ghana	Card
`guatemala_cui`	string	`[0-9\]{13}`	CUI	Guatemala	Card
`india_pan`	string	`[a-zA-Z\]{5}\[0-9\]{4}\[a-zA-Z\]{1}`	PAN	India	Card
`indian_customer_phone`	string	`^[0-9]+$`	The customer’s phone number, often used for identity verification for payments in India.	India	Card
`indonesia_nik`	string	`[0-9\]{16}`	NIK	Indonesia	Card
`japan_id`	string	`[0-9\]{12}`	My Number	Japan	Card
`kenya_id`	string	`[0-9\]{8}`	National ID Card	Kenya	Card
`malaysia_nric`	string	`[0-9\]{12}`	NRIC	Malaysia
`mexico_curp`	string	`[a-zA-Z0-9\]{10,18}`	CURP	Mexico	Card
`morocco_cnie`	string	`[a-zA-Z0-9\]{5,20}`	CNIE	Morocco	Card
`nigeria_nin`	string	`[0-9\]{11}`	NIN	Nigeria	Card
`panama_id`	string	`[0-9\]{8}`	Cedula de Identidad	Panama	Card
`paraguay_ci`	string	`[0-9\]{5,20}`	Cedula de Identidad	Paraguay	Card
`peru_dni`	string	`[0-9\]{8,9}`	A national identity document code for Peruvian cardholders	Peru	Card
`philipines_psn`	string	`[0-9\]{12}`	PSN	Philippines	Card
`senegal_cni`	string	`[0-9\]{13,17}`	CNI or ECOWAS ID Card	Senegal	Card
`south_africa_id`	string	`[0-9\]{13}`	South African Identity Card	South Africa	Card
`tanzania_id`	string	`[0-9\]{20}`	National Identity Card	Tanzania	Card
`thailand_id`	string	`[0-9\]{13}`	Thai Identity Card	Thailand	Card
`turkey_tc_kimlik_no`	string	`[0-9\]{5,20}`	T.C. Kimlik No.	Turkey	Card
`uganda_nic`	string	`[a-zA-Z0-9\]{14}`	National ID number (NIC)	Uganda	Card
`uruguay_ci`	string	`[0-9\]{6,8}`	Cédula de Identidad	Uruguay	Card
`vietnam_vnid`	string	`[0-9\]{9}$`	VNID	Vietnam	Card
`vpa`	string	`^\[\w.-\]+@\[\w\]+$`	VPA	India	Card
`zip_code`	string	`[0-9]`	ZIP code is the term used to describe the postal code system	USA	Card

Access to API

Learn to authenticate API requests and fix validation errors effectively.

Payments

Explore diverse payment options for a seamless, secure transaction experience.

Testing

Simulate payments to test your integration before launching in production.