[
{
"title":"Testing",
"link":"https://docs.solidgate.com/payments/testing/",
"text":"Simulate payments to test your integration before launching in production.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-customizable.svg"
}
,
{
"title":"Create your payment form",
"link":"https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form/",
"text":"Understand how to integrate the payment form into your product.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-payments.svg"
}
,
{
"title":"Billing",
"link":"https://docs.solidgate.com/billing/",
"text":"Smart billing solutions designed for diverse business models.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-global.svg"
}
]
Improve your approval ratio across countries by collecting and providing additional data
When using the
H2H
API
in Solidgate, it is essential to collect and transmit supplementary customer information to ensure successful
Guide
Accept and manage credit card payments from your customers. Cards are the most popular payment method globally, offering convenience and widespread acceptance.
card
or
Guide
Connect alternative payment methods to boost your checkout conversion. Solidgate offers diverse payment methods, aiding merchants in understanding and catering to local preferences globally.
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.
Guide
Easily create a safe and simple payment page.
Payment Page
or
Guide
Understand how to integrate the payment form into your product.
Payment Form
would gather any additional information on your behalf.
Below, find the fields required for specific countries and alternative payment methods.
Country-specific fields
Expand all
Description
A national identity document code should be collected and provided for Argentinian cardholders.
Country
Argentina
Description
National Identity Card
Country
Bangladesh
Description
Cedula de Identidad
Country
Bolivia
Description
CPF
Validation Document - Last two digits are verifiers
Country
Brazil
Description
СNI
Country
Cameroon
Description
Rol Único Tributario
Country
Chile
Description
Citizen ID Number
Country
China
Description
Cedula de Ciudadania
Country
Colombia
Description
Cédula de Identidad
Country
Costa Rica
Description
Identity card
Country
Dominican Republic
Description
Cédula de Identidad
Country
Ecuador
Description
Personal Identification Card
Country
El Salvador
Description
Identity card
Country
Egypt
Description
Ghana Card
Country
Ghana
Description
CUI
Country
Guatemala
Description
PAN
Country
India
Description
VPA
Country
India
Description
NIK
Country
Indonesia
Description
My Number
Country
Japan
Description
National ID Card
Country
Kenya
Description
NRIC
Country
Malaysia
Description
CURP
Country
Mexico
Description
CNIE
Country
Morocco
Description
NIN
Country
Nigeria
Description
Cedula de Identidad
Country
Panama
Description
Cedula de Identidad
Country
Paraguay
Description
A national identity document code for Peruvian cardholders
ZIP code is the term used to describe the postal code system
The zip_code parameter is not included within the payment_type_data objects but follows the structure outlined in the API reference request.
Country
USA
India
This overview assists merchants in seamlessly
Guide
Unified Payments Interface (UPI), India's premier payment solution, boasts high transaction success rates.
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
Processing for non-India-issued cards by Indian providers is currently unavailable. Only two-step payments, auth + settle, are supported.
It is important to note that partial settlements and void transactions are not supported in this process.
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 will be declined initially, 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 will not be accepted for further payments.
One-step payments (charge) 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.
For example: +912221234567
Recurring payments:
up to ₹15,000 can be processed without customer intervention and without
Guide
This process is designed to enable secure and reliable payment processing through the use of 3D Secure (3DS) with challenge authentication flow.
3D Secure
above ₹15,000 are not currently available
All first payments with India-issued cards will 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 in processing status on average for
36
hours, but it could be up to
48
hours.
Latin America
This overview assists merchants in seamlessly
Guide
Mercado Pago, Boleto, and PIX are widely used alternative payment solutions in Latin America, offering familiar checkout experiences.
integrating payment methods
for the Latin American market.
Merchants must inform customers of additional taxes that apply to transactions in these regions.
Brazil
Boleto 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.
PIX 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 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
IOF-FX is a financial tax applied in Brazil for foreign exchange operations.
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 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
Value-Added Tax
VAT
and/or
PAIS tax
Impuesto para una Argentina Inclusiva y Solidaria
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.