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:
- Authorization
- Full capture
- Partial captures
- Purchase (auto-captured)
- Airline data
- Partial refund (up to one per order)
- Full refund
- Void
Online multiple partial captures and refunds can be enabled through configuration. Contact DEUNA to activate these features if required
Supported Payment Methods
Cards
- Visa y Mastercard.
Requirements
Contact your BBVA representative and request the following credentials:
- Your BBVA credentials
Make sure your account is properly configured on the BBVA side.
Integrate BBVA
Integrate BBVA in DEUNA.
1. Look for BBVA in DEUNA
After searching for BBVA in Connections, you must configure BBVA in your store.
2. Configure BBVA in your store
In Connections, a window like the following will open:
- Enter the following credentials:
- In Name enter a name to reference the credential.
- In Currency select the Currency of Merchant Processor available.
- In Terminal ID enter the BBVA's Terminal ID.
- In Afiliation enter the BBVA's afiliation.
- In Terminal Owner enter the BBVA's terminal owner.
- In Terminal Logic Network enter the BBVA's Terminal Logic Network.
- In Terminal Time Offset enter the BBVA's Terminal Time Offset in Minutes.
- 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
3. 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.
Purchase v2 Example
{
"order_type": "AIRLINE_ORDER",
// "market_type": "moto",
"payer_info": {
"email": "[email protected]",
"date_of_birth": "1990-08-30T16:00:00.000Z"
},
"payment_source": {
"method_type": "credit_card",
"card_info": {
"card_number": "4772910000760346", //tarjeta de prueba del PSP, si se quiere que se deniegue poner cualquier otra
"card_holder": "GUSTAVO MENA",
"expiry_month": "01",
"expiry_year": "2030",
"card_cvv": "543",
"card_holder_dni": "43459183",
// "installments": 6,
// "deferred_installment_months": 7,
"zip": "11510",
"city": "Ciudad de Mexico",
"address1": "Jose Luis Lagrange 103",
"state": "CDMX",
"phone": "+5511985176644",
"country": "MX" // Country in ISO 2 preferably
}
},
"anti_fraud_info": {
"ip_address": "192.1.1.0.0",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.6367.29 Safari/537.36",
"device": {
"fingerprint": "eyJSSVNLSUZJRUQiOiJiZmQ2MmNiMy0xMDhiLTU1MmYtOTIwYS0xNWRhODZhZGI2MjIiLCJNRVJDQURPUEFHTyI6ImFybW9yLmFkYzU5NTJjZDFmMTZjNjVmM2ZmMTVhMWFkZDhmODY4NzYyMWU1ZTYzYjMyYWJmZmQ0NWEzMDM0YWNhYWIxN2RmYmEwMGFmZmJlYmQ2YmY0MGJiNjJmYjA4MDhiZTYzODhhZTYzZjU4ZTI3ZDY5MjRiNmIzZTFiMjQ3MTNkYmE1MWFhZmNkZGM5MDY5NjhhMzJiZWQ5NjNmY2UxMTdhOWZhMDdhYjFjN2IyY2Q0YTIzNTVlYTQ4NDM1NTVjMWJkOC5lNWQwOGQyYWE0NDA2MDkzNTE5OGNlYjBhNWI1MmUyNiIsIlNUUklQRV9ESVJFQ1QiOiJyc2VfMVJINmtsQVA2ZXZUVlg2Skd0Nk0ydG5VIn0="
},
"browser_details": {
"screen_height": 1000,
"screen_width": 2000
}
},
"order": {
"order_id": "{{$randomUUID}}",
"currency": "MXN",
"items": [
{
"id": "216",
"name": "Trip Insurance",
"description": "Insurance in case of flight delay or cancel",
"options": "string option",
"total_amount": {
"original_amount": 1000,
"amount": 1000,
"currency": "MXN",
"currency_symbol": "$"
},
"unit_price": {
"amount": 1000,
"currency": "MXN",
"currency_symbol": "$"
},
"tax_amount": {
"amount": 0,
"currency": "MXN",
"currency_symbol": "$"
},
"quantity": 1,
"uom": "string",
"upc": "string",
"sku": "INS45678",
"isbn": "",
"brand": "Insurance",
"manufacturer": "",
"category": "Trip Insurance",
"color": "",
"size": "",
"weight": {
"amount": 0,
"unit": "kg"
},
"image_url": "https://images-staging.getduna.com/95463fb5-6279-4ec3-8ff9-fe07aacd2142/db5b698c57654116_domicilio_216_750x750_1662162887.png?d=200x200&format=webp",
"details_url": "",
"type": "digital",
"taxable": true
}
],
"total_discount": 500,
"shipping_amount": 2500,
"sub_total": 129000, //BEFORE TAXES (iTEMS - DISCOUNTS + SHIPPING)
// "total_tax_amount": 1000,
"total_amount": 129000,
"store_code": "all",
"shipping_methods": [
{
"code": "12345JR",
"name": "Fast Delivery",
"cost": 2500
}
],
"shipping_options": {
"type": "delivery"
},
"shipping_address": {
"id": "204",
"first_name": "Juan",
"last_name": "Silva",
"email": "{{$randomEmail}}",
"address1": "Jose Luis Lagrange 103",
"address2": "Piso 12",
"zipcode": "11510",
"city": "Ciudad de Mexico",
"state_name": "Ciudad de Mexico",
"country_code": "MX",
"identity_document": "IAOI640911TB8",
"identity_document_type": "RUT", //RTC or RUT E.g. IAOI640911TB8
"phone": "+5511985176644",
"lat": -22.943934,
"lng": -43.182984,
"additional_description": "confirmar",
"address_type": "casa"
},
"billing_address": {
"id": "179",
"first_name": "Juan",
"last_name": "Pacheco",
"email": "{{$randomEmail}}",
"address1": "Jose Luis Lagrange 103",
"address2": "Piso 12",
"zipcode": "11510",
"city": "Ciudad de Mexico",
"state_name": "Ciudad de Mexico",
"country_code": "MX",
"identity_document": "IAOI640911TB8",
"identity_document_type": "RUT", //RTC or RUT E.g. IAOI640911TB8
"phone": "+5511985176644",
"lat": -23.555425,
"lng": -46.677048,
"address_type": "casa"
},
"discounts": [
{
"amount": 500,
"display_amount": "1000",
"code": "SUMMER2025",
"reference": "827a7385-7729-4401-882f-ffaf86c9336c",
"description": "Promocion aplicada",
"discount_category": "coupon",
"type": ""
},
{
"amount": 0,
"display_amount": "0",
"code": "5a546263-8a9e-4c58-ac94-7b22953f98dc",
"reference": "5a546263-8a9e-4c58-ac94-7b22953f98dc",
"description": "custom payment when method is Diners",
"discount_category": "promotion",
"type": ""
},
{
"amount": 1000,
"display_amount": "1000",
"code": "BDJY-VWUB-EEDD-NUEZ",
"reference": "38d6fb45-2c0c-42fb-99d3-998cd446e405",
"description": "BDJY-VWUB-EEDD-NUEZ",
"discount_category": "gift_card",
"type": ""
},
{
"amount": 2000,
"display_amount": "1000",
"code": "TYUA-ERTY-LKHS-MANI",
"reference": "59469d9a-0f85-4e57-ad5a-d2cdfe0ba0c1",
"description": "TYUA-ERTY-LKHS-MANI",
"discount_category": "voucher",
"type": ""
}
],
"airline_information": {
"bookingItems": [
{ ///Passenger 1
"pnr": "KFA701", // description field
"ticket_number": "100457010",
"e_ticket": true,
"ticketing_travel_agency": {
"iata_code": "TRA123", //extra2 field
"name": "Expedia"
},
"passenger": {
"user_id": "{{$randomUUID}}",
"first_name": "Gustavo",
"middle_name": "Eduardo",
"last_name": "Mena",
"document_type": "DNI",
"identity_document_number": "07277747",
"email": "[email protected]",
"phone": "+14155688537",
"frequent_flyer_code": "51434591833",
"title": "Mr",
"date_of_birth": "1985-12-31", // YYYY-MM-DD
"country_code": "PE"
},
"legs": [
{
"origin": {
"iata_code": "SEA",
"date": "2024-02-01",
"time": "12:00"
},
"destination": {
"iata_code": "LAX",
"date": "2024-02-01",
"time": "18:00"
},
"carrier_code": "VOI",
"carrier_name": "Volaris",
"flight_number": "VOI899",
"seat_location": "3C",
"fare_basis_code": "Business",
"stopover_code": "",
"sub_total_amount": 2500,
"tax_amount": 250,
"total_amount": 2750
},
{
"origin": {
"iata_code": "LAX",
"date": "2024-02-01",
"time": "23:00"
},
"destination": {
"iata_code": "SEA", // LIM
"date": "2024-02-02",
"time": "07:00"
},
"carrier_code": "VOI",
"carrier_name": "Volaris",
"flight_number": "VOI489",
"seat_location": "4C",
"fare_basis_code": "Business",
"stopover_code": "",
"sub_total_amount": 2500,
"tax_amount": 250,
"total_amount": 2750
}
]
},
{ /// Passenger 2
"pnr": "KFA701", // description field
"ticket_number": "100457011",
"e_ticket": true,
"ticketing_travel_agency": {
"iata_code": "TRA123", //extra2 field
"name": "Expedia"
},
"passenger": {
"user_id": "{{$randomUUID}}",
"first_name": "Lourdes",
"middle_name": "Daniela",
"last_name": "Montenegro",
"document_type": "DNI",
"identity_document_number": "70326536",
"email": "[email protected]",
"phone": "+14155797662",
"frequent_flyer_code": "51703265363",
"title": "Ms",
"date_of_birth": "1989-04-21", // YYYY-MM-DD
"country_code": "PE"
},
"legs": [
{
"origin": {
"iata_code": "SEA", //extra1 field
"date": "2024-02-01",
"time": "12:00"
},
"destination": {
"iata_code": "LAX",
"date": "2024-02-01",
"time": "18:00"
},
"carrier_code": "VOI",
"carrier_name": "Volaris",
"flight_number": "VOI899",
"seat_location": "3C",
"fare_basis_code": "Business",
"stopover_code": "",
"sub_total_amount": 2500,
"tax_amount": 250,
"total_amount": 2750
},
{
"origin": {
"iata_code": "LAX", //extra1 field
"date": "2024-02-01",
"time": "23:00"
},
"destination": {
"iata_code": "SEA", // LIM
"date": "2024-02-02",
"time": "07:00"
},
"carrier_code": "VOI",
"carrier_name": "Volaris",
"flight_number": "VOI489",
"seat_location": "4C",
"fare_basis_code": "Business",
"stopover_code": "",
"sub_total_amount": 2500,
"tax_amount": 250,
"total_amount": 2750
}
]
}
]
}
}
}Request with 3ds Example
{
"order_type": "AIRLINE_ORDER",
"payer_info": {
"email": "[email protected]",
"date_of_birth": "1990-08-30T16:00:00.000Z"
},
"payment_source": {
"method_type": "credit_card",
"card_info": {
"card_number": "4772910000760346",
"card_holder": "GUSTAVO MENA",
"expiry_month": "01",
"expiry_year": "2030",
"card_cvv": "543",
"card_holder_dni": "43459183",
"zip": "11510",
"city": "Ciudad de Mexico",
"address1": "Jose Luis Lagrange 103",
"state": "CDMX",
"phone": "+5511985176644",
"country": "MX",
"secure_authentication": {
"eci": "5", // Visa: 5, 6, 7
"cavv": "00020102294417000001f7204841717461053611", // Base64 format (28 char) or Encoded decimal (40 char)
"xid": "fa0d170b-2fab-4d7d-a852-5b4f8dac003c", // Normally, Visa does not require this field
"flow_type": "frictionless"
}
}
},
"anti_fraud_info": {
"ip_address": "192.1.1.0.0",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.6367.29 Safari/537.36",
"device": {
"fingerprint": "eyJSSVNLSUZJRUQiOiJiZmQ2MmNiMy0xMDhiLTU1MmYtOTIwYS0xNWRhODZhZGI2MjIiLCJNRVJDQURPUEFHTyI6ImFybW9yLmFkYzU5NTJjZDFmMTZjNjVmM2ZmMTVhMWFkZDhmODY4NzYyMWU1ZTYzYjMyYWJmZmQ0NWEzMDM0YWNhYWIxN2RmYmEwMGFmZmJlYmQ2YmY0MGJiNjJmYjA4MDhiZTYzODhhZTYzZjU4ZTI3ZDY5MjRiNmIzZTFiMjQ3MTNkYmE1MWFhZmNkZGM5MDY5NjhhMzJiZWQ5NjNmY2UxMTdhOWZhMDdhYjFjN2IyY2Q0YTIzNTVlYTQ4NDM1NTVjMWJkOC5lNWQwOGQyYWE0NDA2MDkzNTE5OGNlYjBhNWI1MmUyNiIsIlNUUklQRV9ESVJFQ1QiOiJyc2VfMVJINmtsQVA2ZXZUVlg2Skd0Nk0ydG5VIn0="
},
"browser_details": {
"screen_height": 1000,
"screen_width": 2000
}
},
"order": {
"order_id": "{{$randomUUID}}",
"currency": "MXN",
"items": [
{
"id": "216",
"name": "Trip Insurance",
"description": "Insurance in case of flight delay or cancel",
"options": "string option",
"total_amount": {
"original_amount": 148800,
"amount": 148800,
"currency": "MXN",
"currency_symbol": "$"
},
"unit_price": {
"amount": 148800,
"currency": "MXN",
"currency_symbol": "$"
},
"tax_amount": {
"amount": 0,
"currency": "MXN",
"currency_symbol": "$"
},
"quantity": 1,
"uom": "string",
"upc": "string",
"sku": "INS45678",
"isbn": "",
"brand": "Insurance",
"manufacturer": "",
"category": "Trip Insurance",
"color": "",
"size": "",
"weight": {
"amount": 0,
"unit": "kg"
},
"image_url": "https://images-staging.getduna.com/95463fb5-6279-4ec3-8ff9-fe07aacd2142/db5b698c57654116_domicilio_216_750x750_1662162887.png?d=200x200&format=webp",
"details_url": "",
"type": "digital",
"taxable": true
}
],
"total_discount": 20000,
"shipping_amount": 0,
"sub_total": 128800,
"total_amount": 128800,
"store_code": "all",
"shipping_address": {
"id": "204",
"first_name": "Juan",
"last_name": "Silva",
"email": "[email protected]",
"address1": "Jose Luis Lagrange 103",
"address2": "Piso 12",
"zipcode": "11510",
"city": "Ciudad de Mexico",
"state_name": "Ciudad de Mexico",
"country_code": "MX",
"identity_document": "IAOI640911TB8",
"identity_document_type": "RUT",
"phone": "+5511985176644",
"lat": -22.943934,
"lng": -43.182984,
"additional_description": "confirmar",
"address_type": "casa"
},
"billing_address": {
"id": "179",
"first_name": "Juan",
"last_name": "Pacheco",
"email": "[email protected]",
"address1": "Jose Luis Lagrange 103",
"address2": "Piso 12",
"zipcode": "11510",
"city": "Ciudad de Mexico",
"state_name": "Ciudad de Mexico",
"country_code": "MX",
"identity_document": "IAOI640911TB8",
"identity_document_type": "RUT",
"phone": "+5511985176644",
"lat": -23.555425,
"lng": -46.677048,
"address_type": "casa"
},
"discounts": [
{
"amount": 20000,
"display_amount": "20000",
"code": "SUMMER2025",
"reference": "827a7385-7729-4401-882f-ffaf86c9336c",
"description": "Promocion aplicada",
"discount_category": "coupon",
"type": ""
}
],
"airline_information": {
"bookingItems": [
{
"pnr": "KFA5001",
"ticket_number": "10005001",
"e_ticket": true,
"ticketing_travel_agency": {
"iata_code": "TRA123",
"name": "Expedia"
},
"passenger": {
"user_id": "de9b4c78-4a03-4f20-a2e8-fea47fd1fe0f",
"first_name": "Gustavo",
"middle_name": "Eduardo",
"last_name": "Mena",
"document_type": "DNI",
"identity_document_number": "07277747",
"email": "[email protected]",
"phone": "+14155688537",
"frequent_flyer_code": "51434591833",
"title": "Mr",
"date_of_birth": "1985-12-31",
"country_code": "PE"
},
"legs": [
{
"origin": {
"iata_code": "SEA",
"date": "2024-02-01",
"time": "12:00"
},
"destination": {
"iata_code": "LAX",
"date": "2024-02-01",
"time": "18:00"
},
"carrier_code": "VOI",
"carrier_name": "Volaris",
"flight_number": "VOI899",
"seat_location": "3C",
"fare_basis_code": "Business",
"stopover_code": "",
"sub_total_amount": 148800,
"tax_amount": 0,
"total_amount": 148800
},
{
"origin": {
"iata_code": "LAX",
"date": "2024-02-01",
"time": "23:00"
},
"destination": {
"iata_code": "SEA",
"date": "2024-02-02",
"time": "07:00"
},
"carrier_code": "VOI",
"carrier_name": "Volaris",
"flight_number": "VOI489",
"seat_location": "4C",
"fare_basis_code": "Business",
"stopover_code": "",
"sub_total_amount": 2500,
"tax_amount": 0,
"total_amount": 2750
}
]
},
{
"pnr": "KFA123",
"ticket_number": "100458791",
"e_ticket": true,
"ticketing_travel_agency": {
"iata_code": "TRA123",
"name": "Expedia"
},
"passenger": {
"user_id": "2184ad3d-9e7c-4282-890d-e96a06bab55e",
"first_name": "Lourdes",
"middle_name": "Daniela",
"last_name": "Montenegro",
"document_type": "DNI",
"identity_document_number": "70326536",
"email": "[email protected]",
"phone": "+14155797662",
"frequent_flyer_code": "51703265363",
"title": "Ms",
"date_of_birth": "1989-04-21",
"country_code": "PE"
},
"legs": [
{
"origin": {
"iata_code": "SEA",
"date": "2024-02-01",
"time": "12:00"
},
"destination": {
"iata_code": "LAX",
"date": "2024-02-01",
"time": "18:00"
},
"carrier_code": "VOI",
"carrier_name": "Volaris",
"flight_number": "VOI899",
"seat_location": "3C",
"fare_basis_code": "Business",
"stopover_code": "",
"sub_total_amount": 2500,
"tax_amount": 250,
"total_amount": 2750
},
{
"origin": {
"iata_code": "LAX",
"date": "2024-02-01",
"time": "23:00"
},
"destination": {
"iata_code": "SEA",
"date": "2024-02-02",
"time": "07:00"
},
"carrier_code": "VOI",
"carrier_name": "Volaris",
"flight_number": "VOI489",
"seat_location": "4C",
"fare_basis_code": "Business",
"stopover_code": "",
"sub_total_amount": 2500,
"tax_amount": 0,
"total_amount": 2750
}
]
}
]
}
}
}Special considerations and limitations
Billing address
Domestic transactions acquired by BBVA must include the following shopper information in the authorization request:
billing_address.zipcodebilling_address.state-namebilling_address.country_code
This follows the local regulation to withhold tax in the shopper's province. When this data is not supplied, BBVA withhold tax based on the merchant location.
Submit either one of the codes:
- ISO
- Local province codes (COMARB)
| Province code COMARB | Province code ISO | Province Name |
|---|---|---|
| 901 | AR-C | CABA |
| 909 | AR-P | Formosa |
| 919 | AR-D | San Luis |
| 908 | AR-E | Entre Rios |
| 911 | AR-L | La Pampa |
| 917 | AR-A | Salta |
| 906 | AR-H | Chaco |
| 907 | AR-U | Chubut |
| 910 | AR-Y | Jujuy |
| 920 | AR-Z | Santa Cruz |
| 903 | AR-K | Catamarca |
| 904 | AR-X | Cordoba |
| 912 | AR-F | La Rioja |
| 922 | AR-G | Santiago del Estero |
| 918 | AR-J | San Juan |
| 913 | AR-M | Mendoza |
| 914 | AR-N | Misiones |
| 915 | AR-Q | Neuquén |
| 916 | AR-R | Rio Negro |
| 923 | AR-V | Tierra del Fuego |
| 902 | AR-B | Buenos Aires |
| 921 | AR-S | Santa Fe |
| 924 | AR-T | Tucumán |
| 905 | AR-W | Corrientes |
-
Currency Code: Specifies the currency (ISO 4217) code for the relevant country.
-
Country Code: Specifies the ISO Country Codes
-
Airline data
Airline Itinerary Data can be submitted at either authorization or capture, depending on when the booking system generates the ticket number.
DEUNA's system should be prepared to accept airline data in both the authorization and capture requests, in case other airlines choose to include it in the authorization. If the order type is 'airline_order' in DEUNA’s system, this data must be present in at least one of these requests.
Additionally, for purchases with an 'airline_order' type, airline data is mandatory in the purchase request.
-
The number of installments is validated against the maximum number of installments agreed with the acquirer.
-
A payment that is AUTHORIZED can be captured.
-
A partial capture can be performed if necessary.
-
Each authorized payment allows for either a partial or full capture.
-
It is recommended to capture an order within 5 days of the authorization to prevent expiration.
-
A refund can be requested only after a payment reaches the CAPTURED status.
-
Refunds cannot exceed the original captured amount, but one or more partial refunds of the captured amount can be performed.
-
Only one partial refund can be sent per order.
-
A payment can be canceled (Void) only after it reaches the AUTHORIZED status.
-
Cancellation is no longer possible once the payment reaches the CAPTURED status.
-
Partial cancellation allows canceling part of the funds while capturing the remaining funds through a separate capture order modification.
-
Only one partial cancel (void) can be sent per order.
-
Before taking payments in Latin America a legal entity and an acquirer in the country of operation are required
Testing Resources
BBVA credentials
Terminal ID *
00000001
Affiliation *
4694227
Terminal Owner *
DUNA
Terminal Logic Network *
TES1
Terminal Time Offset in Minutes (e.g +1h -> +060) *
+000Postman collection
BBVA Collection.postman_collection.json
Testing cards
| Brand | Type | Card Number | Expiry Month | Expiry Year | CVV |
|---|---|---|---|---|---|
| Visa | Approved | 4772910000760346 | 01 | 2030 | 543 |
| Master | Approved | 5546294000066711 | 09 | 2025 | 613 |
Updated about 13 hours ago