Prosa

This page provides a guide to integrate Prosa with DEUNA.

Supported operations

Prosa 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

Supported payment methods

Cards: Visa and Mastercard.

Requirements

Contact your Prosa representative and request the following credentials:

Your Prosa credential

Make sure your account is properly configured on the Prosa side.

Integrate Prosa

After searching for Prosa in Connections, you must configure Prosa in your store.

1. Configure Prosa 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.

Credential	Prosa Field	Description	Value in Sandbox
Moneda		Processor Currency	MXN
MCC	18 MERCHANT TYPE	Business Line (MCC)	4-digit code. E.g. 3076
Código de Adquirente	32 ACQUIRING INSTITUTION ID CODE	Acquiring bank code	"127" for BAZ
Merchant ID	42 CARD ACCEPTOR ID CODE	Code of the institution that accepts the transaction. Suggested to send as "00000000"	Code provided by Prosa
Receiving Institution Id Code	100 RECEIVING INSTITUTION ID CODE	Applies only to switches. Send the value "000000000"	9-digit code provided by Prosa, if one is not available, place "000000000"
Pre Authorization hold (days)	126.2 Preauthorization Hold	Days you want the authorization to remain valid. Suggested to keep as "00"	Example: "2"
ID Terminal	41 CARD ACCEPTOR TERMINAL ID	Terminal ID, assigned by DEUNA (Can be any value, even repeated)	Suggested value: "00000001"
Afiliación	148.2 Retailer ID	Affiliation code provided by the Merchant's Bank (7 digits for MX)	Example: "8092738"
Terminal Name	120.2 Terminal Name	Terminal code in Deuna	"DEUNA T1"
Dueño de la Terminal	60.2 Owner FIID	Bank FIID - B, P or D depending on the bank + 3 digits	"B127" For BAZ
Red Lógica de la Terminal	60.3 Logic Network	Deuna logic network with Prosa. Constant value "DUNA"	"DUNA"
Time Offset de la Terminal en Minutos (e.g +1h -> +060)	60.4 Time Offset	Time difference of the terminal with Prosa. Constant value "+000"	Suggested value: "+000"
Terminal City	43.2 Terminal City	Abbreviation of the City where the business is located (max 4 characters)	Example: "CDMX"
Terminal State	43.3 Terminal State	State where the business is located (two digits)	Example: "DF"
Terminal Country	43.4 Terminal Country	Country where the business is located (two digits)	Example: "MX"
Terminal ZIP Code	POSTAL CODE	Postal code where the business is located (5 digits)	Example: "11510"

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

Next, you will be able to see your Prosa connection within the Active Connections tab.

2. Process transactions in Prosa

From this point on, you can now process transactions with Prosa through DEUNA.

Purchase v2 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": "4213166111832485",
      "card_holder": "GUSTAVO MENA",
      "expiry_month": "12",
      "expiry_year": "2025",
      "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", 
            "cavv": "00020102294417000001f7204841717461053611", 
            "xid": "fa0d170b-2fab-4d7d-a852-5b4f8dac003c", 
            "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": "e6460816-a9dc-4391-bb67-c7bf1e2e7247",
    "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": 5004,
    "total_amount": 5004,
    "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

List of available acquirers

Acquirer	Code
Banamex	002
Santander	003
BBVA	012
NvoSantander	014
HSBC	021
Banbajio	030
Ixe	032
Inbursa	036
Mifel	042
Banregio	058

BILLING ADDRESS

Domestic transactions acquired by Prosa must include the following shopper information in the authorization request:

billing_address.zipcode
billing_address.state-name
billing_address.country_code

This follows the local regulation to withhold tax in the shopper's province. When this data is not supplied, Prosa withholds tax based on the merchant location.

Submit either the:

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

Prosa credentials

Moneda *
MXN

MCC *
3076

Código de Adquirente *
127

Merchant ID *
123456789

Receiving Institution Id Code *
000000000

Pre Authorization hold (days) *
2

ID Terminal *
00000001

Afiliación *
8092738

Terminal Name *
DEUNA T1

Dueño de la Terminal *
B127

Red Lógica de la Terminal *
DUNA

Time Offset de la Terminal en Minutos (e.g +1h -> +060) *
+000

Terminal City *
CDMX

Terminal State *
DF

Terminal Country *
MX

Terminal ZIP Code *
11510

Postman collection

Credentials Merchant MX.postman_environment.json

Prosa Collections.postman_collection.json

Testing cards

Brand	Type	Card Number	Expiry Month	Expiry Year	CVV
MC		5111142120402941	11	2025
Visa Internacional		4772133024074624	05	2026
Visa Internacional		4761739001010119	12	2026
Visa		413330089010525	12	2026
Visa		4295220106262892	12	2025
MC		5456319000618894	12	2025
MC		5288519108161382	12	2027
Visa		4213166111832485	12	2027
MC		5491380215493207	12	2026
Visa	Credit	4941330102412991	12	2025	536
Visa		4931580006616542	12	2025
MC	Credit	5470466016187968	12	2027	247
MC	Debit	5174390000095921	05	2029