DEUNA

DEUNA is a unified commerce platform for Latin America that provides payment processing, checkout, and fraud prevention tools. Through its partnership with EBANX, DEUNA merchants can process credit card payments across multiple Latin American countries using EBANX as a payment gateway within DEUNA's admin dashboard.

This guide covers how to configure EBANX as a gateway in DEUNA, the supported operations and countries, testing procedures, and limitations.

Features

• Dashboard-based configuration - Set up EBANX as a payment gateway directly from the DEUNA admin panel, with no custom code required.
• Multiple operations - Support for authorization, capture (full and partial), purchase (auto-capture), refunds (full and partial), and voids.
• Installments - Offer installment payment plans to customers, with customizable options per merchant agreement.
• 3D Secure - Enable 3DS authentication through DEUNA to add an extra layer of security for card transactions.
• Multi-country coverage - Process payments across multiple Latin American countries through a single integration.

Requirements

Before starting the integration, ensure you have the following:

• DEUNA account - An active DEUNA merchant account. If you do not have one, visit DEUNA to get started.
• EBANX credentials - Your EBANX Private Key and Public Key. Contact EBANX Sales to set up your account.

How it works

1. 1 The merchant configures EBANX credentials (Private Key and Public Key) in the DEUNA Admin dashboard and selects the operation mode.

2. 2 The customer initiates a purchase on the merchant's website or application.

3. 3 The merchant creates a payment request through DEUNA.

4. 4 DEUNA routes the card transaction to EBANX for processing.

5. 5 EBANX processes the payment with the local acquirer and returns the result to DEUNA.

6. 6 DEUNA delivers the payment response to the merchant.

Supported payment methods

Payment Method	Countries	Currencies	Description
Visa (Credit)	Argentina, Brazil, Chile, Colombia, Costa Rica, Dominican Republic, Ecuador, Guatemala, Mexico, Panama, Paraguay, Peru, Uruguay	ARS, BRL, CLP, COP, CRC, DOP, GTQ, MXN, PAB, PEN, PYG, USD, UYU	Visa credit card payments
Mastercard (Credit)	Argentina, Brazil, Chile, Colombia, Costa Rica, Dominican Republic, Ecuador, Guatemala, Mexico, Panama, Paraguay, Peru, Uruguay	ARS, BRL, CLP, COP, CRC, DOP, GTQ, MXN, PAB, PEN, PYG, USD, UYU	Mastercard credit card payments

Key details

• Integration type - Gateway-configured (via DEUNA Admin dashboard)
• Supported operations - Authorization, Capture (full and partial), Purchase (auto-capture), Refund (full and partial), Void, Installments
• 3D Secure - Supported through DEUNA's 3DS integration
• Card on File - Not applicable (DEUNA manages tokenization)
• Settlement currency - Configured during EBANX onboarding

Info

Multiple partial captures can be enabled through configuration. Contact DEUNA to activate this feature if required.

Instructions

Follow the steps below.

1. Set up your EBANX account

   Contact the EBANX integrations team to establish your merchant account and obtain your EBANX credentials. During onboarding, EBANX will configure the supported countries, payment methods, and settlement parameters for your account.

   You will need:

   • Private Key - Used for server-side authentication.
   • Public Key - Used for client-side operations.

2. Connect EBANX as a gateway in DEUNA

   Log in to your DEUNA Admin dashboard and navigate to the Connections section. Search for EBANX in the list of available payment gateways.

   In the configuration window, complete the following fields:

   • Name - Enter a name to reference the credential.
   • Currency - Select the currency of the Merchant Processor available.
   • Private Key - Enter your EBANX Private Key.
   • Public Key - Enter your EBANX Public Key.
   • Operation type - Choose Purchase (auto-capture) or Authorization.
   • 3DS - Choose if you want to activate 3DS.

   Click Connect to complete the setup.

   Once you complete the steps, you will see a success message.

3. Process payments with EBANX

   After successful configuration, EBANX will appear within the Active Connections tab in DEUNA. From this point on, you can process card transactions with EBANX through DEUNA.

   Use DEUNA's standard payment integration (Direct API, Payment Widget, or Plugins) to accept payments. All payment routing to EBANX is handled automatically by DEUNA based on your payment strategy configuration.

   For detailed integration instructions, refer to the DEUNA documentation:

   • Direct API - Server-to-server payment processing.
   • Payment Widget - Pre-built checkout UI component.
   • Payment Strategies - Configure routing rules for transaction processing.

4. Congratulations!

   Your DEUNA integration is now configured to process credit card payments in Latin America through EBANX. Use the testing section below to validate your setup before going live.

Limitations

General limitations

• No direct EBANX API access - Merchants interact exclusively with the DEUNA API and admin dashboard. EBANX-specific features not exposed through DEUNA (such as EBANX Payment Page or EBANX.js) are not available.
• Credit card payments only - Only Visa and Mastercard credit cards are supported through the DEUNA channel. Debit cards and other EBANX-supported payment methods (such as Pix, Boleto, or local alternatives) are not available via DEUNA.
• Partial refunds - Only one partial refund can be sent per order.

Argentina billing address

Domestic transactions acquired by EBANX in Argentina must include billing address information in the authorization request (billing_address.zipcode, billing_address.state_name, billing_address.country_code). This follows local regulations to withhold tax in the shopper's province. When this data is not supplied, EBANX withholds taxes based on the merchant location.

Warning

For Argentina transactions, submit either ISO province codes (e.g., AR-C for CABA) or local COMARB province codes (e.g., 901 for CABA) in the billing address state field.

Operation rules

• A payment that is authorized can be captured. It is recommended to capture an order within 5 days of the authorization to prevent expiration.
• A partial or full capture can be performed per authorized payment.
• A refund can be requested only after a payment reaches the captured status. Refunds cannot exceed the original captured amount.
• A payment can be voided only after it reaches the authorized status. Cancellation is no longer possible once the payment reaches the captured status.
• EBANX processes DEUNA transactions as cross-border payments. A cross-border merchant agreement with EBANX is required before taking payments.

Testing

Sandbox testing

DEUNA provides a sandbox environment for testing payment flows without processing real transactions. Use your EBANX sandbox credentials (Sandbox Private Key and Public Key) when configuring the gateway for testing.

To test in sandbox mode:

1. Configure the EBANX gateway in DEUNA using your EBANX sandbox credentials.
2. Process a test transaction using the test card numbers below.
3. Verify that the transaction appears in the DEUNA dashboard with the correct status.

Test cards

Brand	Type	Card Number	Expiry Month	Expiry Year	CVV
Visa	Approved	4111115666052208	12	2030	123
Mastercard	Approved	5555556355564617	12	2030	123
Visa	Rejected	4918019199883839	12	2030	123

Going live

Before going live, verify the following:

• EBANX has confirmed your merchant account is active for production.
• The EBANX gateway is activated in your DEUNA Admin with production credentials.
• You have successfully processed test transactions in the DEUNA sandbox for all countries you intend to operate in.
• Error handling is implemented for declined transactions and timeouts.
• Installment configuration is aligned with your merchant agreement.

Resources

Sample Cards

Click here to view mock card data to validate your payment integration.

Click to explorechevron_right

API Reference

Click here to access detailed API documentation to integrate efficiently.

Click to explorechevron_right

Mock Customer Data

Click here to view mock customer data for testing and validating user flows.

Click to explorechevron_right

Error Codes

Click here to review common error codes to troubleshoot and resolve issues quickly.

Click to explorechevron_right

Still need help?

We hope this article was helpful. If you still have questions, you can explore the following options:

• Merchant support: Contact our support team at sales.engineering@ebanx.com for assistance.
• Not a partner yet? Please complete the Merchant Signup Form, and our commercial team will reach out to you.