When using the
H2H
API
in Solidgate, it is essential to collect 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 field of the payment_type_data object.
It is 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 used to authenticate the individual initiating the payment, such as india_pan in the case of India.
Payment Page or Payment Form would gather any additional information on your behalf.
Below, find the fields required for specific countries and alternative payment methods. argentina_dni string [0-9\]{7,9}Description
A national identity document code should be collected and provided for Argentinian cardholders.
Country
Argentina
bangladesh_nic string [0-9]{13,17}Description
National Identity Card
Country
Bangladesh
bolivia_ci string [0-9]{5,20}Description
Cedula de Identidad
Country
Bolivia
brazil_cpf numeric [0-9]{11}Description
CPF
Validation Document - Last two digits are verifiers
Country
Brazil
brazil_customer_phone string ^[0-9]{10,11}$Description
Mobile phone number for customer identification and verification during payments in Brazil.
Country
Brazil
cameroon_cni string [0-9]{8}Description
СNI
Country
Cameroon
chile_ci string .{8,9}Description
Rol Único Tributario
Country
Chile
china_id string [0-9]{5,20}Description
Citizen ID Number
Country
China
colombia_cc string [0-9]{6,10}Description
Cedula de Ciudadania
Country
Colombia
costa_rica_ci string [0-9]{9}Description
Cédula de Identidad
Country
Costa Rica
dominicana_id string [0-9]{11}Description
Identity card
Country
Dominican Republic
ecuador_ci string [0-9]{5,20}Description
Cédula de Identidad
Country
Ecuador
el_salvador_id string [0-9]{9,11}Description
Personal Identification Card
Country
El Salvador
egypt_id string [0-9]{14}Description
Identity card
Country
Egypt
ghana_card string [a-zA-Z0-9]{13}Description
Ghana Card
Country
Ghana
guatemala_cui string [0-9]{13}Description
CUI
Country
Guatemala
india_pan string [a-zA-Z]{5}[0-9]{4}[a-zA-Z]{1}Description
PAN
Country
India
india_vpa string ^.{1,100}@.{1,30}$Description
VPA
Country
India
india_zip string ^[0-9]{6}$Description
ZIP Code used for address verification in India.
Country
India
indian_customer_phone string ^[0-9]{10}$Description
Mobile phone number for customer identity verification in India, often required for payments.
Country
India
indonesia_nik string [0-9]{16}Description
NIK
Country
Indonesia
japan_id string [0-9]{12}Description
My Number
Country
Japan
kenya_id string [0-9]{8}Description
National ID Card
Country
Kenya
malaysia_nric string [0-9]{12}Description
NRIC
Country
Malaysia
mexico_curp string [a-zA-Z0-9]{10,18}Description
CURP
Country
Mexico
morocco_cnie string [a-zA-Z0-9]{5,20}Description
CNIE
Country
Morocco
nigeria_nin string [0-9]{11}Description
NIN
Country
Nigeria
panama_id string [0-9]{8}Description
Cedula de Identidad
Country
Panama
paraguay_ci string [0-9]{5,20}Description
Cedula de Identidad
Country
Paraguay
peru_dni string [0-9]{8,9}Description
A national identity document code for Peruvian cardholders
Country
Peru
philippines_psn string [0-9]{12}Description
PSN
Country
Philippines
senegal_cni string [0-9]{13,17}Description
CNI or ECOWAS ID Card
Country
Senegal
south_africa_id string [0-9]{13}Description
South African Identity Card
Country
South Africa
tanzania_id string [0-9]{20}Description
National Identity Card
Country
Tanzania
thailand_id string [0-9]{13}Description
Thai Identity Card
Country
Thailand
turkey_tc_kimlik_no string [0-9]{5,20}Description
T.C. Kimlik No.
Country
Turkey
uganda_nic string [a-zA-Z0-9]{14}Description
National ID number (NIC)
Country
Uganda
uruguay_ci string [0-9]{6,8}Description
Cédula de Identidad
Country
Uruguay
vietnam_vnid string [0-9]{9}$Description
VNID
Country
Vietnam
zip_code string [0-9]Description
ZIP code is the term used to describe the postal code system
Thezip_code parameter is not included within the payment_type_data objects but follows the structure outlined in the API reference request.
Country
USA
China
This overview assists merchants in seamlessly integrating Alipay and WeChat Pay for the Chinese market, addressing key aspects such as status delays, transaction limits, decline reasons, and specific payment flows.
Merchants must ensure compliance with China’s specific requirements to avoid integration errors and optimize transaction success rates.Payment flows and limitations
Alipay Supports one-time and recurring payments. The payment method is not saved with the merchant for one-time purchases. The customer authenticates via redirect to the Alipay app each time. WeChat Pay Supports one-time and recurring payments. The payment method is not saved with the merchant for one-time purchases. The customer authenticates via redirect to the WeChat Pay app each time.Only one active mandate is allowed per user per merchant. Since a mandate is generated only during the initial payment, any upsells or additional subscriptions must use the existing recurring token.
- If a
tokenexists, use it for the upsell - If no
tokenexists, run the initial payment flow to create a new mandate
India
This overview assists merchants in seamlessly integrating payment solutions for the Indian market, addressing crucial aspects like status delays, transaction limits, decline reasons, and specific payment flows.
Merchants must ensure compliance with India’s specific requirements to avoid integration errors and optimize transaction success rates.Payment flows and limitations
CardsProcessing for non-India-issued cards by Indian providers is currently unavailable. Only two-step payments, auth + settle, are supported.
Authorization for transactions in this system has a duration of 3 days, after which an automatic refund is initiated by the provider.
Cards that do not support recurring charges are declined, and MOTO (Mail Order/Telephone Order) transactions are unavailable.
It is mandatory to settle the payment to proceed with subsequent payments. If the payment is not settled, the token not be accepted for further payments. UPI One-time and subscription payments are used. Phone number requirement Mandatory for all transactions. The number should be 8 to 15 digits long, including the country code, and contain only digits and the '+' symbol.Example +912221234567
Recurring payments:
- up to ₹15,000 per transaction can be processed without customer intervention and without 3D Secure
- above ₹15,000 per transaction are not currently available
All first payments with India-issued cards go through 3D Secure authentication.
In the recurring payment flow, customers receive a pre-debit notification 24 hours before the charge. If the customer opts to decline, a decline response is issued. If there is no decline, a successful response is given, and transactions stay inprocessing status on average for
36
hours, but it could be up to
48
hours.
Limitations for Apple Pay and Google Pay
Apple Pay and Google Pay are not supported for processing payments in India. While both payment methods are widely used globally, India primarily relies on the Unified Payments Interface (UPI) for mobile payments. Therefore, merchants in India must use UPI-based solutions rather than Apple Pay or Google Pay for their transactions.
Latin America
This overview assists merchants in seamlessly integrating payment methods for the Latin American market.
Merchants must inform customers of additional taxes that apply to transactions in these regions.Brazil
BoletoBoleto operates on a one-time payment flow. A payment slip is generated and presented to the customer, who can pay it through various channels (online banking, ATMs, retail shops).
Once the slip is paid, funds confirmation occurs within 1 to 3 business days on average. Settlements happen automatically once payment is confirmed. PixPix also operates on a one-time payment flow, enabling real-time transfers. This method usually provides instant payment confirmation, resulting in faster order processing.
Transactions typically settle within minutes, improving conversion rates through immediate confirmations. Mercado PagoMercado Pago supports one-time payment and subscription flow. Customers complete the payment within the Mercado Pago interface, streamlining the flow.
Payment confirmation timelines vary, but confirmations usually arrive within the same day, offering a convenient checkout experience for local customers. Taxes in Brazil IOF-FX is collected for transactions in Brazil. Any other taxes that may apply to the sale of goods or services. You must inform your customers that additional taxes may also apply to the transaction.Argentina
Mercado PagoMercado Pago is available as a one-time payment and subscription flow. Shoppers finalize the payment using Mercado Pago’s interface and receive real-time or near real-time payment confirmations.
Recommended for mobile-focused customers, Mercado Pago simplifies the checkout process and can support various local payment instruments. Taxes in Argentina VAT and/or PAIS tax apply to transactions in Argentina. You must inform your customers that other taxes may be levied for the sale of goods or services.It is your responsibility to ensure compliance with local tax regulations and to communicate any applicable taxes directly to your customers.