dLocal support for Latin America (LATAM) cards 

dLocal support for is now deprecated. No new merchants will be onboarded. Existing users can still refer to the documentation for their current setup.

Latin America is an emerging marketplace and offers immense potential for growth across all e-commerce businesses. This region depends on mostly local payment networks since it offers customers ease of transaction and additional benefits while making it easier for merchants to comply with country-specific regulations.

To bridge this gap, has partnered with dLocal , a market leader in payment solutions for emerging economies to facilitate payments from customers across Latin America using both international and local card schemes.

Chargebee now allows you to configure your integration to accept payment via LATAM cards.


The following prerequisites must be met in order to utilize the dLocal payment gateway:

  • Your  account must be configured to accept LATAM card payments. Read more here .

  • Payments are restricted to users residing in the following countries: Argentina, Brazil, Chile, Colombia, Ecuador, Mexico, Peru, and Uruguay.

  • Local compliance regulations require users to submit relevant identification documents. Read more here.


The following limitations apply to the usage of's dLocal payment gateway in Chargebee:

  • The integration currently only supports international, domestic, co-branded cards of Visa and Mastercard.

  • Gift subscriptions cannot be bought using

  • 3D Secure authentication is not supported for payments processed using dLocal.

Document List 

To process payments using dLocal payment gateway, customers must provide a document of identification. Review the list below for country-wise accepted documents:

  • Argentina: Documento Nacional de Identidad (DNI) or Clave Única de Identificación Tributaria (CUIT)

  • Brazil: Cadastro de Pessoas Físicas (CPF) or Cadastro Nacional da Pessoa Jurídica (CNPJ)

  • Chile: Cedula de Identidad (CI) or Rol Único Tributario (RUT)

  • Colombia: Cedula de Ciudadania (CC)

  • Ecuador: Cedula de Identidad (CI)

  • Mexico: Clave Única de Registro de Población (CURP)

  • Peru: Documento Nacional de Identidad (DNI)

  • Uruguay: Cedula de Identidad (CI)

Configuring - LATAM Cards 

Follow the steps below to enable LATAM card payments via checkout on your Chargebee site:

  1. Configure on your Chargebee site. Read more here.

  2. If configured, access the Settings page. Click Settings > Configure Chargebee > Payment Gateway >

  3. Click Manage.

  4. Toggle on Enable Payment from local cards in Latin America.

  5. Review your Smart Routing settings.

  6. Access the Checkout and Self-serve portal settings.
    To do this, Click Configure Chargebee>Checkout and Self-Serve Portal> Fields> Payments.

  7. Update the Country field in the Checkout & Self-Serve Portal as Mandatory.

  • Addition of this mandatory field ensures that the country name must be input by the customer.
  • The selection of a supported Latin America country determines if the payment must be processed via dLocal integration.

Outcome: Your integration is now enabled to process payments using LATAM cards.

Processing Payments 

While using this integration for payments from a supported LATAM country, the Country of Residence and Document ID is dynamically displayed requiring customer input. Failure to provide this information will result in the payment being processed as a regular payment via the payment gateway.

Note: All acceptable document IDs associated with a country of residence will display in the tool-tip.

Was this article helpful?