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:

OperationBBVA NameMTI Request / Response
AuthorizationAutorizacion0100/ 0110
Purchase (Auto Capture)Venta0200 / 0210
Full Refund-Next day / Partial RefundDevolucion0200 / 0210
Full / Partial CaptureCaptura0220 / 0230
Full Refund-Same dayCancelacion0420 / 0430
VoidCancelacion0420 / 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:

OperationBBVA NameMTI Request / ResponseDeuna Status Pre SettlementDeuna Status after Settlement
AuthorizationAutorizacion0100/ 0110AuthorizedAuthorized (no change)
Purchase (Auto Capture)Venta0200 / 0210ProcessingProcessed
Full Refund-Next day / Partial RefundDevolucion0200 / 0210Refunding / Partial RefundingRefunded / Partial Refunded
Full / Partial CaptureCaptura0220 / 0230Capturing / Partial CapturingCaptured / Partial Captured
Full Refund-Same dayCancelacion0420 / 0430RefundedRefunded (no change, online cancellation)
VoidCancelacion0420 / 0430VoidedVoided (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

  1. In Connections, a window like the following will open:
  1. Enter the following credentials:
    CredentialBBVA FieldDescriptionValue in Sandbox
    MonedaProcessor CurrencyMXN
    ID de la terminal41 Card Acceptor Terminal IdentificationMerchant's connection ID Suggested value "00000001""00000001"
    Afiliación48 Additional Data-Retailer DataAffiliation code provided by the Merchant's Bank (7 digits for MX)Example: "8092738"
    Dueño de la Terminal60.1 Identificador del dueño de la
    Terminal
    Connection's owner. Default value "DUNA""DUNA"
    Red Lógica de la Terminal60.2 Red Lógica a la que pertenece
    la Terminal
    Deuna logic network with Prosa. Constant value "PRD1""TES1"
    Time Offset de la Terminal en Minutos (e.g +1h -> +060)60.3 Time OffsetTime difference of the terminal with BBVA. Default value "+000""+000"
  2. Choose the type of operation you want to perform:
    • Purchase
    • Authorization
  3. Choose if you want to activate 3DS.
  4. Click Connect.
  5. 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) *
+000

Simulating Results

To simulare approved, denied, or denied by timeout transactions, the following conditions must be applied:

ResultBilling Address emailComments
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

BBVA Collection.postman_collection.json


Did this page help you?