PayU
This page provides a guide to integrate PayU with DEUNA.
Supported Operations
PayU integration in your payment strategy with DEUNA allows you to perform the following operations:
- Authorization
- Full capture
- Partial captures
- Purchase (auto-captured)
- Partial refund (up to one per order)
- Full refund
- Void
- Installment
- 3DS DEUNA
- 3DS with PSP
Online multiple partial captures and refunds can be enabled through configuration. Contact DEUNA to activate these features if required
Supported Payment Methods
Cards
- Visa
- Mastercard
- Diners
- Amex
Active countries and currencies
- Colombia (COL)
- Argentina (ARS)
- Perú (PEN, USD)
- Panama (USD)
Requirements
Contact your PayU representative and request the following credentials:
- Your PayU credentials
Make sure your account is properly configured on the PayU side.
Integrate PayU
After searching for PayU in Connections, you must configure PayU in your store.
1. Configure PayU 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 Merchant ID enter the PayU’s Merchat ID.
- In API Key enter the PayU’s API Key.
- In API Login enter the PayU’s API Login.
- In Account ID enter the PayU’s Account ID.
- Las credenciales ingresadas deben ser compatibles con la selección
- Choose the type of operation you want to perform:
- Purchase
- Authorization
- Choose if you want to activate Multiple Partial Refunds.
- Choose if you want to activate 3DS with DEUNA or PSP
- Click Connect.
Once you complete the steps, you will see a success message.
3. Process payments with PayU
Next, you will be able to see your PayU connection within the Active Connections tab.
From this point on, you can now process transactions with PayU through DEUNA.
Purchase v2 example
{
"payer_info": {
"email": "[email protected]"
},
"order_type": "AIRLINE_ORDER",
"payment_source": {
"method_type": "credit_card",
"card_info": {
"expiry_month": "01",
"expiry_year": "2029",
"card_holder_dni": "",
"card_holder": "Omar Guzhnay",
"card_number": "5555556355564617",
"card_cvv": "123",
"address1": "Jose Luis Lagrange 123, Piso 12",
"address2": "Polanco I Sección",
"zip": "11510",
"city": "MIGUEL HIDALGO",
"state": "CIUDAD DE MÉXICO",
"country": "MX",
"phone": "5930962917",
"installments": "1"
}
},
"order": {
"order_id": "4cac429d-68e5-44da-a12d-1571dbb43537",
"currency": "ARS",
"statement_descriptor":"test",
"market_type": "ecommerce",
"items": [
{
"id": "00ab2d23-f44a-4782-aa7c-bb4fadeddfe3",
"name": "Item #1",
"description": "Description Item #1",
"total_amount": {
"original_amount": 115000,
"amount": 115000,
"total_discount": 0,
"currency": "ARS",
"currency_symbol": "$"
},
"unit_price": {
"amount": 100000,
"currency": "ARS",
"currency_symbol": "$"
},
"tax_amount": {
"amount": 15000,
"currency": "ARS",
"currency_symbol": "$"
},
"quantity": 1,
"image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
"taxable": true
},
{
"id": "3cb41aec-1be8-4255-a386-94bb316a8157",
"name": "Item #2",
"description": "Description Item #2",
"total_amount": {
"original_amount": 115000,
"amount": 115000,
"total_discount": 0,
"currency": "ARS",
"currency_symbol": "$"
},
"unit_price": {
"amount": 100000,
"currency": "ARS",
"currency_symbol": "$"
},
"tax_amount": {
"amount": 15000,
"currency": "ARS",
"currency_symbol": "$"
},
"quantity": 1,
"image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
"taxable": true
}
],
"sub_total": 200000,
"tax_amount": 30009,
"total_tax_amount": 30009,
"total_amount": 230009,
"store_code": "all",
"billing_address": {
"id": "4255",
"first_name": "Omar",
"last_name": "Guzhnay",
"email": "[email protected]",
"address1": "Jose Luis Lagrange 123, Piso 12",
"address2": "Polanco I Sección",
"zipcode": "11510",
"city": "Buenos Aires",
"state_code": "AR-B",
"state_name": "Buenos Aires",
"country_code": "AR",
"identity_document": "30123456",
"identity_document_type": "",
"phone": "5930962917",
"lat": -22.943934,
"lng": -43.182984,
"additional_description": "confirm",
"address_type": "home"
},
"airline_information": {
"bookingItems": [
{
"airline_3_digit_code": "139",
"airline_iata_designator": "AM",
"pnr": "KFA5001",
"ticket_number": "10005001",
"e_ticket": true,
"ticketing_travel_agency": {
"agency_invoice_number": "5001001000000009",
"iata_code": "TRA123",
"name": "Expedia"
},
"ancillaries": [
{
"description": "Premium Meal",
"service_category": "c",
"ticket_number": "10005001",
"total_amount": 100,
"type": "Meal"
}
],
"legs": [
{
"carrier_code": "AM",
"carrier_name": "Aeromexico",
"fare_basis_code": "VL7PR",
"flight_number": "AM690",
"seat_location": "12A",
"service_class": "Economy",
"stopover_code": "X",
"sub_total_amount": 100,
"tax_amount": 0,
"total_amount": 100,
"origin": {
"city": "Seattle",
"iata_code": "SEA",
"date": "2024-02-01",
"time": "12:00"
},
"destination": {
"city": "Los Angeles",
"iata_code": "LAX",
"date": "2024-02-01",
"time": "14:30"
}
},
{
"carrier_code": "AM",
"carrier_name": "Aeromexico",
"fare_basis_code": "VL7PR",
"flight_number": "AM691",
"seat_location": "15F",
"service_class": "Economy",
"stopover_code": "X",
"sub_total_amount": 100,
"tax_amount": 0,
"total_amount": 100,
"origin": {
"city": "Los Angeles",
"iata_code": "LAX",
"date": "2024-02-01",
"time": "18:00"
},
"destination": {
"city": "Mexico City",
"iata_code": "MEX",
"date": "2024-02-01",
"time": "23:00"
}
}
],
"passenger": {
"user_id": "de9b4c78-4a03-4f20-a2e8-fea47fd1fe0f",
"frequent_flyer_code": "51434591833",
"country_code": "PE",
"document_type": "DNI",
"identity_document_number": "07277747",
"title": "Mr",
"first_name": "Orlando",
"middle_name": "Juan",
"last_name": "Perez",
"email": "[email protected]",
"phone": "+14155688537",
"date_of_birth": "1985-12-31"
}
},
{
"airline_3_digit_code": "139",
"airline_iata_designator": "AM",
"pnr": "KFA5002",
"ticket_number": "10005002",
"e_ticket": true,
"ticketing_travel_agency": {
"agency_invoice_number": "5001001000000009",
"iata_code": "TRA123",
"name": "Expedia"
},
"ancillaries": [
{
"description": "Premium Meal",
"service_category": "c",
"ticket_number": "10005001",
"total_amount": 100,
"type": "Meal"
}
],
"legs": [
{
"carrier_code": "AM",
"carrier_name": "Aeromexico",
"fare_basis_code": "VL7PR",
"flight_number": "AM690",
"seat_location": "12A",
"service_class": "Economy",
"stopover_code": "X",
"sub_total_amount": 100,
"tax_amount": 0,
"total_amount": 100,
"origin": {
"city": "Seattle",
"iata_code": "SEA",
"date": "2024-02-01",
"time": "12:00"
},
"destination": {
"city": "Los Angeles",
"iata_code": "LAX",
"date": "2024-02-01",
"time": "14:30"
}
},
{
"carrier_code": "AM",
"carrier_name": "Aeromexico",
"fare_basis_code": "VL7PR",
"flight_number": "AM691",
"seat_location": "15F",
"service_class": "Economy",
"stopover_code": "X",
"sub_total_amount": 100,
"tax_amount": 0,
"total_amount": 100,
"origin": {
"city": "Los Angeles",
"iata_code": "LAX",
"date": "2024-02-01",
"time": "18:00"
},
"destination": {
"city": "Mexico City",
"iata_code": "MEX",
"date": "2024-02-01",
"time": "23:00"
}
}
],
"passenger": {
"user_id": "f5e1b2c3-6d7a-4e9f-8c0d-1a2b3c4d5e6f",
"frequent_flyer_code": "98765432109",
"country_code": "US",
"document_type": "Passport",
"identity_document_number": "P12345678",
"title": "Ms",
"first_name": "Maria",
"middle_name": "Isabel",
"last_name": "Rodriguez",
"email": "[email protected]",
"phone": "+12125551234",
"date_of_birth": "1990-05-15"
}
}
]
}
}
}Special considerations and limitations
Billing adress
Domestic transactions acquired by PayU must include the shopper's billing_address.zipcode, billing_address.state-name, billing_address.country_code in the authorization request. This follows the local regulation to withhold tax in the shopper's province. When this data is not supplied, PayU withhold tax based on the merchant location.
Submit either the ISO or local (COMARB) province codes (but not both)
| 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
- 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.
- Multiple partial refund can be sent per order.
- Partial refunds, meaning an amount less than the total transaction value, can be applied after settlement (midnight), starting from a T+2 period.
- 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.
- Full cancel (void) can be sent per order.
- The installments can be customized to offer a specific number of payments and can include interest-free options or charges defined by the merchant. How it Works:
- The customer chooses the installments - Through the Get Installment API the customer will be able to obtain the available installment payment options. The response will include the installment number along with the installment amount excluding interest. This service will not return interest rates, as it is a direct agreement with the acquirer or issuer.
- Payment processing through DEUNA - We process the payment with the respective installments directly with the PSP.
- Transactions utilizing a
card_idwill be processed without the need to provide the Card Verification Value (CVV), thanks to tokenization with the PSP. - Before taking payments in Latin America a legal entity and an acquirer in the country of operation are required
Updated 2 days ago