Help Center

Use these tips to implement and validate the Payment Form effectively. They act as early validation steps, covering everything from BIN-based extra fields and custom styles to browser support and iframe requirements. This helps you spot gaps early, speed up launch, and accept payments confidently.

Additional fields

The Payment Form checks the Card BIN and receives a list of necessary additional fields according to information about the BIN country (the first six digits).

Also, depending on the provider, the customer’s phone number parameter is often used to verify the identity of the person making a payment, such as with india_pan in India.

• Country Argentina
• Country Code ( ISO-3166 Wiki ) ARG
• Field Title DNI

• Country Bangladesh
• Country Code ( ISO-3166 Wiki ) BGD
• Field Title National identity card

• Country Bolivia
• Country Code ( ISO-3166 Wiki ) BOL
• Field Title Cedula de Identidad

• Country Brazil
• Country Code ( ISO-3166 Wiki ) BRA
• Field Title CPF

• Country Brazil
• Country Code ( ISO-3166 Wiki ) BRA
• Field Title Mobile phone number

• Country Cameroon
• Country Code ( ISO-3166 Wiki ) CMR
• Field Title CNI

• Field title Name on card
• Description This field is used to enter the name of the cardholder as it appears on the card. It is required for transactions from specific countries. For some PSPs, if the merchant does not provide this value, it is filled with the default John Snow.
• Supported countries Argentina ARG, Bangladesh BGD, Bolivia BOL, Brazil BRA, Cameroon CMR, Chile CHL, China CHN, Colombia COL, Costa Rica CRI, Dominican Republic DOM, Ecuador ECU, Egypt EGY, El Salvador SLV, Ghana GHA, Guatemala GTM, India IND, Indonesia IDN, Japan JPN, Kenya KEN, Malaysia MYS, Mexico MEX, Morocco MAR, Nigeria NGA, Panama PAN, Paraguay PRY, Peru PER, Philippines PHL, Senegal SEN, South Africa ZAF, Tanzania TZA, Thailand THA, Turkey TUR, Uganda UGA, Uruguay URY, and Vietnam VNM.

• Country Chile
• Country Code ( ISO-3166 Wiki ) CHL
• Field Title Rol Único Tributario

• Country China
• Country Code ( ISO-3166 Wiki ) CHN
• Field Title Citizen ID Number

• Country Colombia
• Country Code ( ISO-3166 Wiki ) COL
• Field Title Cedula de Ciudadania

• Country Costa Rica
• Country Code ( ISO-3166 Wiki ) CRI
• Field Title Cédula de Identidad

• Country Dominican Republic
• Country Code ( ISO-3166 Wiki ) DOM
• Field Title Identity card

• Country Ecuador
• Country Code ( ISO-3166 Wiki ) ECU
• Field Title Cédula de Identidad

• Country El Salvador
• Country Code ( ISO-3166 Wiki ) SLV
• Field Title Personal Identification Card

• Country Egypt
• Country Code ( ISO-3166 Wiki ) EGY
• Field Title Identity card

• Country Ghana
• Country Code ( ISO-3166 Wiki ) GHA
• Field Title Ghana Card

• Country Guatemala
• Country Code ( ISO-3166 Wiki ) GTM
• Field Title CUI

• Country India
• Country Code ( ISO-3166 Wiki ) IND
• Field Title PAN

• Country India
• Country Code ( ISO-3166 Wiki ) IND
• Field Title ZIP Code

• Country India
• Country Code ( ISO-3166 Wiki ) IND
• Field Title Mobile phone number

• Country Indonesia
• Country Code ( ISO-3166 Wiki ) IDN
• Field Title NIK

• Country Japan
• Country Code ( ISO-3166 Wiki ) JPN
• Field Title My Number

• Country Kenya
• Country Code ( ISO-3166 Wiki ) KEN
• Field Title National ID Card

• Country Malaysia
• Country Code ( ISO-3166 Wiki ) MYS
• Field Title NRIC

• Country Mexico
• Country Code ( ISO-3166 Wiki ) MEX
• Field Title CURP

• Country Morocco
• Country Code ( ISO-3166 Wiki ) MAR
• Field Title CNIE

• Country Nigeria
• Country Code ( ISO-3166 Wiki ) NGA
• Field Title NIN

• Country Pakistan
• Country Code ( ISO-3166 Wiki ) PAK
• Field Title Computerized National Identity Card
• Validation 13 digits

• Country Panama
• Country Code ( ISO-3166 Wiki ) PAN
• Field Title Cedula de Identidad

• Country Paraguay
• Country Code ( ISO-3166 Wiki ) PRY
• Field Title Cédula de Identidad

• Country Peru
• Country Code ( ISO-3166 Wiki ) PER
• Field Title DNI

• Country Philippines
• Country Code ( ISO-3166 Wiki ) PHL
• Field Title PSN

• Country Senegal
• Country Code ( ISO-3166 Wiki ) SEN
• Field Title CNI or ECOWAS ID Card

• Country South Africa
• Country Code ( ISO-3166 Wiki ) ZAF
• Field Title South African Identity Card

• Country Tanzania
• Country Code ( ISO-3166 Wiki ) TZA
• Field Title National Identity Card

• Country Thailand
• Country Code ( ISO-3166 Wiki ) THA
• Field Title Thai Identity Card

• Country Turkey
• Country Code ( ISO-3166 Wiki ) TUR
• Field Title T.C. Kimlik No.

• Country Uganda
• Country Code ( ISO-3166 Wiki ) UGA
• Field Title National ID number (NIC)

• Country Uruguay
• Country Code ( ISO-3166 Wiki ) URY
• Field Title Cédula de Identidad

• Country Vietnam
• Country Code ( ISO-3166 Wiki ) VNM
• Field Title VNID

• Country United States
• Country Code ( ISO-3166 Wiki ) USA
• Field Title ZIP code
• Validation
  • USA [0-9]{5}(?:[0-9]{4})?$ - 5 or 9 digits
  • Other countries [0-9]{5} - 5 digits

Style additional fields

Additional fields classes are formed as follows:

 "class": "input_group zip_code additional_field"

You can customize all additional fields at once using the additional_field class. In this case, styles are applied to all additional field classes described in the table above.

PaymentFormSdk.init({
  ...restData,
  styles: {
    'additional_field': {
      'input': {
        'color': 'red'
      }
    }
  }
})

If you want to customize a specific field, you need to apply styles to this specific additional field class name.

PaymentFormSdk.init({
  ...restData,
  styles: {
    'guatemala_cui': {
      'input': {
        'color': 'red'
      }
    }
  }
})

Supported browsers

Solidgate Payment Form supports the following browsers:

• Chrome Mobile 64+ version
• Safari 10+ version
• Samsung Browser 17+ version

• Chrome 37+ version
• Safari 10.1+ version
• Firefox 31+ version
• Opera 25+ version
• Microsoft Edge 15+ version

For browsers not explicitly supported, support is limited as follows:

• customer’s browser must support TLS 1.2. If TLS 1.2 is not supported, the payment form is not displayed
• certain browser extensions may interfere with the proper functioning of the payment form
• payment form stable performance cannot be guaranteed when rendered inside in-app browsers like Facebook or Instagram
• browsers must be sufficiently modern, including support for Promises Reference in JavaScript
• bug reports are addressed, but proactive testing of other browsers is not conducted

Supported translations

Payment Form is automatically translated based on the customer’s browser language settings. If the browser language is not supported, the form is displayed in en English.

If you prefer to display the Payment Form in a specific language, pass any IETF Wiki language tag from the above list into the paymentIntent object.

Iframe and HTTP limitations

Payment Form is not suitable for embedding on HTTP web pages. Use HTTPS to ensure the secure transmission of sensitive data.

To work in iframe, the Payment Form requires payments to be allowed in iframe:

<iframe src="https://merchant.example/payment-form" allow="payment"></iframe>

Specifically, Apple Pay requires verification of iframes and top-level domains through the Solidgate Hub .

Common initialization errors related to third-party when integrating the Solidgate Payment Form SDK are the following:

• Feature-Policy violation that arises in third-party iframes without proper permissions.
• Apple Pay security origin issue that occurs when starting Apple Pay sessions from a document with a differing security origin than its top-level frame.
• Insecure document error that is triggered by attempting Apple Pay transactions on non-HTTPS web pages.