BBVA
This page provides a guide to integrate BBVA with DEUNA.
Supported operations
BBVA integration in your payment strategy with DEUNA allows you to perform the following operations:
| Operation | BBVA Name | MTI Request / Response |
|---|---|---|
| Authorization | Autorizacion | 0100/ 0110 |
| Purchase (Auto Capture) | Venta | 0200 / 0210 |
| Full Refund-Next day / Partial Refund | Devolucion | 0200 / 0210 |
| Full / Partial Capture | Captura | 0220 / 0230 |
| Full Refund-Same day | Cancelacion | 0420 / 0430 |
| Void | Cancelacion | 0420 / 0430 |
Supported features
- 3DS (Deuna's or External MPI)
- Recurrent Payments
- MSI / MCI
- MOTO
- Airline Information
Multiple partial captures and refunds can be enabled through configuration. Contact DEUNA to activate these features
Supported payment methods
- Debit and Credit Cards: Visa and Mastercard.
Settlement Process
BBVA integration requires a two-step process to offer a more reliable and efficient reconciliation process. Instead of clearing every single transaction one by one in real-time, all approved authorizations are grouped and sent together at the end of the day in a single batch file (like the TEF file). This makes daily accounting, auditing, and error-checking significantly more manageable. The cut-off happens at 11:00 PM CDMX time.
This process is reflected in the payment status in Deuna as explained in the following table:
| Operation | BBVA Name | MTI Request / Response | Deuna Status Pre Settlement | Deuna Status after Settlement |
|---|---|---|---|---|
| Authorization | Autorizacion | 0100/ 0110 | Authorized | Authorized (no change) |
| Purchase (Auto Capture) | Venta | 0200 / 0210 | Processing | Processed |
| Full Refund-Next day / Partial Refund | Devolucion | 0200 / 0210 | Refunding / Partial Refunding | Refunded / Partial Refunded |
| Full / Partial Capture | Captura | 0220 / 0230 | Capturing / Partial Capturing | Captured / Partial Captured |
| Full Refund-Same day | Cancelacion | 0420 / 0430 | Refunded | Refunded (no change, online cancellation) |
| Void | Cancelacion | 0420 / 0430 | Voided | Voided (no change, online cancellation) |
E-Commerce Reconciliation Information provided by BBVA
The merchant will receive from BBVA a file structured with a Business Header, Detail Records, and a Totals Trailer. The following information will be detailed for each transaction:
- Transaction Identification: The Retrieval Reference Number (RRN) provided by the merchant, the authorization code, and the transaction type (Sale or Return).
- Platform Source: A specific code identifying the origin as e-commerce, which will be "WEB" for transactions in Mexican Pesos or "WDB" for US Dollars.
- Dates and Times: The exact operation date and time, the BBVA processing date, and the settlement date indicating when the account is credited.
- Card Details: The first 6 digits (BIN) and the last 4 digits of the card used, the card type (Credit or Debit), and the Issuer brand (e.g., VISA, Mastercard, BBVA, Banamex, Prosa).
- Financials and Fees: The authorized amount, the revolving amount, discount rates, and a detailed breakdown of all applied commissions and taxes (IVA).
- Special Programs: If applicable, detailed fee and term information for promotions (installments), purchases made with points, or Dynamic Currency Conversion (DCC) bonuses.
Integrate BBVA
After searching for BBVA in Connections, you must configure BBVA in your store.

1. Configure BBVA in your store
- In Connections, a window like the following will open:

- Enter the following credentials:
Credential BBVA Field Description Value in Sandbox Moneda Processor Currency MXN ID de la terminal 41 Card Acceptor Terminal Identification Merchant's connection ID Suggested value "00000001" "00000001" Afiliación 48 Additional Data-Retailer Data Affiliation code provided by the Merchant's Bank (7 digits for MX) Example: "8092738" Dueño de la Terminal 60.1 Identificador del dueño de la
TerminalConnection's owner. Default value "DUNA" "DUNA" Red Lógica de la Terminal 60.2 Red Lógica a la que pertenece
la TerminalDeuna logic network with Prosa. Constant value "PRD1" "TES1" Time Offset de la Terminal en Minutos (e.g +1h -> +060) 60.3 Time Offset Time difference of the terminal with BBVA. Default value "+000" "+000" - Choose the type of operation you want to perform:
- Purchase
- Authorization
- Choose if you want to activate 3DS.
- Click Connect.
- Once you complete the steps, you will see a success message
2. Process payments with BBVA
You will see the BBVA connection within the Active Connections tab
From this point on, you can now process transactions with BBVA through DEUNA.

3. Testing your BBVA connection in Sandbox
Credentials
Terminal ID *
00000001
Affiliation *
4694227
Terminal Owner *
DUNA
Terminal Logic Network *
TES1
Terminal Time Offset in Minutes (e.g +1h -> +060) *
+000Simulating Results
To simulare approved, denied, or denied by timeout transactions, the following conditions must be applied:
| Result | Billing Address email | Comments |
|---|---|---|
| Approved | [email protected] | Transaction will be approved regardless of the card brand, amount, etc. |
| Denied | [email protected] | |
| Denied by Timeout | [email protected] | An automatic reversal request will be triggered |
"billing_address": \{
"id": "179",
"first_name": "Juan",
"last_name": "Pacheco",
"email": "[email protected]", //[email protected]" [email protected]"Using a different value will deny the transaction without an specific error code ⚠️
Postman collection
Updated 10 days ago