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:

Supported features

• 3DS (Deuna's or External MPI)
• Recurrent Payments
• MSI / MCI
• MOTO
• Airline Information

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:

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.

Expand

1. Configure BBVA in your store

1. In Connections, a window like the following will open:

Expand

2. 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 Terminal	Connection's owner. Default value "DUNA"	"DUNA"
   Red Lógica de la Terminal	60.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 Offset	Time difference of the terminal with BBVA. Default value "+000"	"+000"

3. Choose the type of operation you want to perform:

   • Purchase
   • Authorization

4. Choose if you want to activate 3DS.

5. Click Connect.

6. 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.

Expand

#

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:

    "billing_address": \{
        "id": "179",
        "first_name": "Juan",
        "last_name": "Pacheco",
        "email": "test@success.com", //test@decline.com"  test@timeout.com"

Using a different value will deny the transaction without an specific error code ⚠️

Postman collection

Request the current BBVA PayConnect Postman collection from your DEUNA integration team.