When using the
H2H
API
in Solidgate, it is essential to collect and transmit supplementary customer information to ensure successful
Guide
Handle card payment operations from checkout through settlement with 3D Secure, tokenization, retry strategies, and refund management.
card
or
Guide
Accept region-specific payment methods like Pix, iDEAL, PayPal, and more to expand market reach and lift checkout conversion rates.
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
Set up a Solidgate-hosted payment page by configuring your API request, setting order parameters, and redirecting customers to checkout.
Payment Page
or
Guide
Set up the Solidgate payment form with step-by-step instructions for script loading, container mounting, and payment request configuration.
Payment Form
would gather any additional information on your behalf.
China
This overview assists merchants in seamlessly integrating
Guide
Accept Alipay payments from Chinese consumers with QR code and redirect-based checkout flows for cross-border e-commerce transactions.
Alipay
and
Guide
Accept WeChat Pay to reach over one billion Chinese consumers with in-app and QR-code-based mobile payment flows for cross-border sales.
WeChat Pay
for the Chinese market, addressing key aspects such as status delays, transaction limits, decline reasons, and specific payment flows.
Payment flows and limitations
Only one active mandate is allowed per customer 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
Guide
Accept UPI payments in India with instant bank-to-bank transfers through a government-backed real-time payment infrastructure network.
integrating payment solutions
for the Indian market, addressing crucial aspects like status delays, transaction limits, decline reasons, and specific payment flows.
Payment flows and limitations
Processing 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.
Recurring payments:
- up to ₹15,000 per transaction 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 per transaction are not currently available
All first payments with India-issued cards go through 3D Secure authentication.
processing status on average for
36
hours, but it could be up to
48
hours.
Limitations for Apple Pay and Google Pay
Guide
Accept Apple Pay payments across iOS, macOS, and Safari with Touch ID and Face ID authentication for secure, frictionless card checkout.
Apple Pay
and
Guide
Accept Google Pay payments across Android apps and web browsers with biometric authentication, network tokenization, and quick checkout.
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
Guide
Accept UPI payments in India with instant bank-to-bank transfers through a government-backed real-time payment infrastructure network.
(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
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.
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).
Pix includes a one-time flow with instant confirmation for Pix QR, plus Pix Automático for scheduled recurring charges under the BCB enrollment standard (API). SmartPix adds one-time and recurring options via Open Finance and bank authorization.
Mercado Pago supports one-time payment and subscription flow. Customers complete the payment within the Mercado Pago interface, streamlining the flow.
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.
Value-Added Tax is a consumption tax added to goods and services at each stage of production and distribution. VAT and/or PAIS tax
Impuesto para una Argentina Inclusiva y Solidaria, a cost disguised as a levy that residents of the country must pay when engaging in foreign currency transactions. 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.