D-Local

This guide will walk you through the process of integrating D-Local with NORBr.

Step 1: Contract Signature

sign a contract with D-Local and get access to their back office

Step 2: Collect your credentials

head to the back office and sign in to your account. from the left side menu, navigate to Settings > Integration

Locate your x_login, x_trans_key and _secret key _and note them for the next step


Step 3: Configure the webhooks

Scroll down to the endpoint configuration section fill in the Payins notification URL

For Sandbox environment:https://webhook-sandbox.norbr.io/partner/dlocal

For Production environment: https://webhook.norbr.io/partner/dlocal

Step 4: Add a Merchant Contract to your Payment Network

  1. Log into your Merchant Account.
  2. Navigate to: Payment Network → Service Providers → Payment Providers → Add a Partner
  3. From the drop-down list, select DLocal.
  4. Give your contract a name for easier identification: eg. PSP name.
  5. Setup general setting and fill in the credentials you earlier retrieved.
  • Merchant Contract ID will populate automatically.
  • Settlement currency: select from the drop-down menu. You will only see the available ones.
  • Select sales channel.
  • Authentication and Risk Assessment: leave without changes.
  • Connection settings: fill in the credentials you retrieved.
  • To activate the contract set the status to active.

Step 5: Activate payment methods

Once you set up the connection by creating the Merchant Contract, you will be able to activate payment methods available for this Partner.

In the settings of your Merchant Contract where you earlier filled in the credentials and put other settings in place, you will see a section Payment Methods with two sub-sections: Active and Available.

To activate a payment method, simply drag and drop it from Available to Active.

For testing:

Use any card like: 4111 1111 1111 1111 with any value for cvc and a future expiry date