PayU
Esta página proporciona una guía para integrar PayU con DEUNA.
En esta página
Operaciones soportadas
La integración de PayU en tu estrategia de pagos con DEUNA te permite realizar las siguientes operaciones:
- Autorización
- captura completa
- Capturas parciales
- Compra (captura automática)
- Reembolso parcial (hasta uno por pedido)
- Reembolso completo
- Anulación
- Cuota
- 3DS DEUNA
- 3DS con PSP
Métodos de pago admitidos
Tarjetas
- visa
- Mastercard
- Comensales
- Amex
Países y monedas activos
- Colombia (COL)
- Argentina (ARS)
- Perú (PEN, USD)
- Panamá (USD)
Requisitos
Contacta a tu representante PayU y solicita las siguientes credenciales:
- Tus credenciales PayU
Integra PayU#
Luego de buscar PayU en Connections, debes configurar PayU en tu tienda.
1. Configura PayU en tu tienda
En Conexiones se abrirá una ventana como la siguiente:
- Ingrese las siguientes credenciales:
- En Nombre introduzca un nombre para hacer referencia a la credencial.
- En Moneda seleccione la moneda del procesador comercial disponible.
- En Merchant ID ingresa el ID de Merchat de PayU.
- En Clave API ingresa la Clave API de PayU.
- En Inicio de sesión API Ingresa al Login API de PayU.
- En Account ID ingresa el ID de Cuenta de PayU.
- Las credenciales ingresadas deben ser compatibles con la selección
- Elija el tipo de operación que desea realizar:
- Compra
- Autorización
- Elige si quieres activar Múltiples reembolsos parciales.
- Elige si quieres activar 3DS con DEUNA o PSP
- Clic Conectar.
Una vez que complete los pasos, verá un mensaje de éxito.
3. Procesar pagos con PayU
A continuación, podrás ver tu conexión PayU dentro de la pestaña Conexiones Activas.
A partir de este momento ya podrás procesar transacciones con PayU a través de DEUNA.
Ejemplo de compra v2
JSON
{
"payer_info": {
"email": "omar_guzhnay@gmail.com"
},
"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": "omar_guzhnay@gmail.com",
"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": "user5074@mail.net",
"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": "maria.rodriguez@example.com",
"phone": "+12125551234",
"date_of_birth": "1990-05-15"
}
}
]
}
}
}Consideraciones y limitaciones especiales#
dirección de facturación
Las transacciones nacionales adquiridas por PayU deben incluir la información del comprador. billing_address.zipcode, billing_address.state-name, billing_address.country_code en la solicitud de autorización. Esto sigue la regulación local para retener impuestos en la provincia del comprador. Cuando no se suministran estos datos, PayU retiene impuestos según la ubicación del comerciante.
Envíe los códigos de provincia ISO o local (COMARB) (pero no ambos)
| Código de provincia COMARB | Código de provincia ISO | Nombre de la provincia |
|---|---|---|
| 901 | AR-C | CABA |
| 909 | AR-P | Formosa |
| 919 | AR-D | sanluis |
| 908 | AR-E | Entre Ríos |
| 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 | Córdoba |
| 912 | AR-F | 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 | Río Negro |
| 923 | AR-V | Tierra del Fuego |
| 902 | AR-B | buenos aires |
| 921 | AR-S | Santa Fé |
| 924 | AR-T | Tucumán |
| 905 | AR-W | Corrientes |
Consideraciones adicionales
- Código de moneda: especifica el código de moneda (ISO 4217) para el país correspondiente.
- Código de país: especifica el Códigos ISO de países
- El número de cuotas se valida contra el número máximo de cuotas acordado con el adquirente.
- Un pago que es AUTHORIZED puede ser capturado.
- Se puede realizar una captura parcial si es necesario.
- Cada pago autorizado permite una captura parcial o total.
- Se recomienda capturar un pedido dentro de los 5 días posteriores a la autorización para evitar su vencimiento.
- Se puede solicitar un reembolso sólo después de que el pago llegue al CAPTURED status.
- Los reembolsos no pueden exceder el monto capturado original, pero se pueden realizar uno o más reembolsos parciales del monto capturado.
- Se pueden enviar múltiples reembolsos parciales por pedido.
- Los reembolsos parciales, es decir, una cantidad inferior al valor total de la transacción, se pueden aplicar después de la liquidación (medianoche), a partir de un período T+2.
- Un pago puede cancelarse (anularse) sólo después de que alcance el AUTHORIZED status.
- La cancelación ya no es posible una vez que el pago llega al CAPTURED status.
- Se puede enviar una cancelación completa (anulación) por pedido.
- Las cuotas se pueden personalizar para ofrecer una cantidad específica de pagos y pueden incluir opciones sin intereses o cargos definidos por el comerciante. Cómo funciona:
- El cliente elige las cuotas: a través de la API Get Installment, el cliente podrá obtener las opciones de pago a plazos disponibles. La respuesta incluirá el número de la cuota junto con el monto de la cuota sin incluir los intereses. Este servicio no devolverá tasas de interés, ya que es un acuerdo directo con el adquirente o emisor.
- Procesamiento de pagos a través de DEUNA - Procesamos el pago con las respectivas cuotas directamente con el PSP.
- Transacciones utilizando un
card_idse procesará sin necesidad de proporcionar el Valor de Verificación de Tarjeta (CVV), gracias a la tokenización con la PSP. - Antes de realizar pagos en América Latina se requiere una entidad legal y un adquirente en el país de operación.
Análisis antifraude
- PayU ofrece funciones antifraude para mantener altas tasas de aprobación y devoluciones de cargo controladas
- Las transacciones sospechosas identificadas por PayU permanecerán en Deuna como estado de pago Procesando mientras PayU realiza una revisión manual de las mismas.
- Una vez que PayU finalice su análisis, Deuna cambiará el estado del pago de Procesando a Procesado o Rechazado e informará al comerciante sobre esta actualización a través de un webhook.
- Esta funcionalidad requiere información clave como:
- Huella digital del dispositivo. Sigue esto sección para conocer los pasos detallados para obtenerlo.
- Comercio electrónico: facturación, envío y detalles de la aerolínea
- Órdenes aéreas: PNR, información del itinerario, detalles del pasajero
- De manera similar, PayU requiere el ID de sesión del comprador en el sitio web del comerciante. PayU espera la cookie de sesión del comerciante (a menudo llamada simplemente "ID de sesión"). Este es el identificador único que su sitio web asigna a un visitante para realizar un seguimiento de su carrito de compras o del estado de inicio de sesión.
- El nombre depende de la tecnología con la que esté construido su sitio web:
- PHP / Magento / WooCommerce: PHPSESSID
- Java/Primavera: JSESSIONID
- Nodo.js: conectar.sid
- ASP.NET: ASP.NET_SessionId
- VTEX / Shopify: A menudo llamado checkout, cart_token o _shopify_s.
- ¿Dónde puedo encontrar el ID de sesión en mi sitio web?
- Seleccione Inspeccionar y en aplicación o almacenamiento, busque la carpeta de cookies
- Seleccione su sitio web y busque el nombre que coincida con su tecnología (por ejemplo, PHPSESSID).
- La cadena dentro de la columna Valor es exactamente lo que necesita enviar (más comúnmente un UUID)
- El nombre depende de la tecnología con la que esté construido su sitio web:
- ¿Cómo enviar esta información a Deuna?
-
- Compra v2
- metadata.additional_data.cookie
- Compra v2
- Opción 1: anti_fraud_info.cookies[].value
- Opción 2: metadatos.additional_data.cookie
- Compra v2