Dlocal Payment Settings

Dlocal provided a greater diversification of payment options for merchants to choose from, which includes Debit/ Credit card and Online Payment.

In this article, we will guide you to integrate Dlocal with your SHOPLINE store for customer to choose during check out.


To setup Dlocal payment method, merchants will first need to register an account in Dlocal and integrate the payment gateway in SHOPLINE admin panel.


1. Dlocal Cards Payment Settings

After merchants get a Dlocal account ready, please proceed to SHOPLINE admin > [Settings] > [Payment] > [Third-party service providers].mceclip0.png


Choose [Dlocal] > [Select].mceclip0.png


Look for the info in your Dlocal account, fill in accordingly > Click [Activate Dlocal] to complete the setup.mceclip1.png


2. Dlocal Online Payment Settings

SHOPLINE admin > [Settings] > [Payment] > [Add Other payment methods].mceclip2.png


Choose [Dlocal Payment] > [Select].mceclip2.png


Look for the info in your Dlocal account, fill in accordingly > Click [Activate Dlocal] to complete the setup.



To integrate Dlocal payment gateway in your store, you would need to:

  • Add IP address in your Dlocal account as per below:


For stores located in regions other than USA, please fill in below IP address in your Dlocal account:


For stores located in USA region, please fill in below IP address in your Dlocal account:


You may also copy the IP address stated in SHOPLINE admin during the setup as per below:mceclip3.png


  • Dlocal would require customers from certain regions to provide personal information such as Identity number during checkout otherwise the transaction might be failed. You may enable [Additional information]settings in SHOPLINE admin > [Settings] > [Checkout Settings] for the required countries (Click here for more info)



Q1: Why do I see a prompt reminder that Dlocal payment is unavailable?

A1: Each channel has strict usage rules, including country, currency, transaction limit, etc. SHOPLINE will determine the validity of the channel in advance based on the store settings and transaction information. When the channel is unavailable, the corresponding payment method will be grayed out and unavailable. Shopline's detection rules mainly include:

  • Whether the current "ship to" country is valid according to the list of countries supported by Dlocal.
  • Whether the current store settlement currency is valid according to the list of currencies supported by Dlocal.
  • Whether the current transaction amount is valid according to the maximum and minimum transaction limits is supported by SHOPLINE.
  • Please note that this limit has covered multiple channels, and there may be inconsistencies between channel rules and that of SHOPLINE. If you have any questions, please contact your Merchant Success consultant. 


Q2: What are SHOPLINE's transaction limit regulations?

A2: Based on SHOPLINE's management standards, the current minimum transaction limit for each  third-party payment service channel is as follows:

    • Supported currencies in integer format: BIFCLFDJFGNFISKJPYKMFKRWPYGRWFUGXVNDVUVXAFXOFand XPF. The minimum transaction limit is $1.
    • The remaining currency bits retain two-digit precision, the minimum transaction limit is $0.10, and there is no maximum transaction limit.

Q3: Why couldn't I proceed refund to my customers?

A3: Due to Dlocal limitation, Dlocal only supports to proceed refund for payment made via Cards, but not Online payment.


For customers who made payment via Online Payment, merchants may transfer the payment manually to customer's account.


Have more questions? Submit a request