Skip to main content
dLocal is a global payments platform that helps you accept local payment methods and cards across emerging markets. Nequi is a popular mobile wallet in Colombia that provides digital payment and financial services.

​
Setup

Please follow the common dLocal instructions to get set up with Nequi. Next, make sure to enable Nequi as a payment method on the configured account.

​
Features

  • Partial refunds - Refund a portion of the captured amount
  • Refunds - Full refund support
  • Settlement reporting - Access to settlement reports
  • Transaction sync - Automatic transaction status synchronization

​
Supported countries

dLocal supports transactions from buyers in CO.

​
Supported currencies

dLocal supports processing payments in COP.

​
Limitations

  • Tokenization - Payment method tokenization is not supported
  • Capture - Delayed capture is not supported
  • Void - Transaction void is not supported

​
Integration

For Nequi, the default integration is through a redirect to a hosted payments page. Start by creating a new transaction with the following required fields. 
var transaction = await client.Transactions.CreateAsync(
    transactionCreate: new TransactionCreate()
    {
        Amount = 1299,
        Currency = "COP",
        Country = "CO",
        PaymentMethod =
            TransactionCreatePaymentMethod.CreateCheckoutSessionWithUrlPaymentMethodCreate(
                new RedirectPaymentMethodCreate()
                {
                    Method = "nequi",
                    RedirectUrl = "https://example.com/callback",
                }
            ),
    }
);
After the transaction is created, the API response includes payment_method.approval_url and the status is set to buyer_approval_pending. Redirect the buyer to the approval_url so they can complete the payment. After approval the buyer is redirected to the redirect_url you provided when creating the transaction. Do not rely solely on the redirect - either poll the transaction or (recommended) rely on webhooks to detect the final status (for example capture_succeeded or failure states).

​
Wallet

Nequi may require some additional information to be passed via dLocal to enable the wallet payment. For this purpose, a wallet option is available in the API. To enable this feature, pass in the following connection options for dLocal when making a payment. 
POST /transactions

{
    "amount": 2000000,
    "country": "CO",
    "currency": "COP",
    "intent": "capture",
    "connection_options": {
        "dlocal-nequi": {
            "wallet": {
                "name": "John Smith", // defaults to the billing name
                "email": "john@example.com", // defaults to the billing email
                "username": "johndoe", // defaults to the billing email
                "token": "abc123", // defaults to null
                "verify": true //defaults to false
            }
        }
    },
}
Please contact dLocal for more information on how to exactly use these wallet options.