PagueU
Esta página fornece um guia para integrar PayU com DEUNA.
Operações Suportadas
A integração do PayU na sua estratégia de pagamento com DEUNA permite realizar as seguintes operações:
- Autorização
- Captura completa
- Capturas parciais
- Compra (capturada automaticamente)
- Reembolso parcial (até um por pedido)
- Reembolso total
- Vazio
- Parcela
- 3DS DEUNA
- 3DS com PSP
Métodos de pagamento suportados
Cartões
- Visto
- Mastercard
- Jantares
- Amex
Países e moedas ativos
- Colômbia (COL)
- Argentina (ARS)
- Peru (PEN, USD)
- Panamá (USD)
Requisitos
Entre em contato com seu representante PayU e solicite as seguintes credenciais:
- Suas credenciais PayU
Integrar PayU#
Após pesquisar por PayU no Connections, você deve configurar o PayU em sua loja.
1. Configure PayU em sua loja
No Connections, uma janela como a seguinte será aberta:
- Insira as seguintes credenciais:
- Em Nome insira um nome para fazer referência à credencial.
- Em Moeda selecione a moeda do processador do comerciante disponível.
- Em Merchant ID insira o ID Mercat do PayU.
- Em Chave de API insira a chave API do PayU.
- Em Login da API insira o login da API PayU.
- Em Account ID insira o ID da conta PayU.
- As credenciais inseridas devem ser compatíveis com a seleção
- Escolha o tipo de operação que deseja realizar:
- Comprar
- Autorização
- Escolha se deseja ativar Vários reembolsos parciais.
- Escolha se deseja ativar 3DS com DEUNA ou PSP
- Clique Conectar.
Depois de concluir as etapas, você verá uma mensagem de sucesso.
3. Processe pagamentos com PayU
A seguir, você poderá ver sua conexão PayU na guia Conexões ativas.
A partir de agora você pode processar transações com PayU através da DEUNA.
Exemplo 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"
}
}
]
}
}
}Considerações e limitações especiais#
Endereço de cobrança
As transações domésticas adquiridas pela PayU devem incluir o valor do comprador billing_address.zipcode, billing_address.state-name, billing_address.country_code na solicitação de autorização. Isto segue a regulamentação local para retenção de impostos na província do comprador. Quando esses dados não são fornecidos, PayU retém o imposto com base na localização do estabelecimento comercial.
Envie os códigos de província ISO ou local (COMARB) (mas não ambos)
| Código da província COMARB | Código da província ISO | Nome da província |
|---|---|---|
| 901 | AR-C | CABA |
| 909 | AR-P | Formosa |
| 919 | AR-D | São Luís |
| 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 | Córdoba |
| 912 | AR-F | La Rioja |
| 922 | AR-G | Santiago del Estero |
| 918 | AR-J | São João |
| 913 | AR-M | Mendoza |
| 914 | AR-N | Missões |
| 915 | AR-Q | Neuquén |
| 916 | AR-R | Rio Negro |
| 923 | AR-V | Terra do Fogo |
| 902 | AR-B | Buenos Aires |
| 921 | AR-S | Santa Fé |
| 924 | AR-T | Tucumán |
| 905 | AR-W | Corrientes |
Considerações adicionais
- Código da moeda: especifica o código da moeda (ISO 4217) do país relevante.
- Código do país: especifica o Códigos de país ISO
- O número de parcelas é validado em relação ao número máximo de parcelas acordado com o adquirente.
- Um pagamento que é AUTHORIZED pode ser capturado.
- Uma captura parcial pode ser realizada, se necessário.
- Cada pagamento autorizado permite uma captura parcial ou total.
- Recomenda-se capturar um pedido no prazo de 5 dias após a autorização para evitar a expiração.
- Um reembolso só pode ser solicitado após o pagamento chegar ao CAPTURED status.
- Os reembolsos não podem exceder o valor original capturado, mas podem ser realizados um ou mais reembolsos parciais do valor capturado.
- Vários reembolsos parciais podem ser enviados por pedido.
- As restituições parciais, ou seja, um valor inferior ao valor total da transação, poderão ser aplicadas após a liquidação (meia-noite), a partir de um período D+2.
- Um pagamento só pode ser cancelado (Anulado) depois de atingir o AUTHORIZED status.
- O cancelamento não é mais possível quando o pagamento chega ao CAPTURED status.
- O cancelamento total (anulado) pode ser enviado por pedido.
- As parcelas podem ser customizadas para oferecer um número específico de pagamentos e podem incluir opções sem juros ou cobranças definidas pelo lojista. Como funciona:
- O cliente escolhe o parcelamento - Através da API Get Parcelamento o cliente poderá obter as opções de parcelamento disponíveis. A resposta incluirá o número da parcela junto com o valor da parcela, excluindo juros. Este serviço não retornará taxas de juros, pois é um acordo direto com o adquirente ou emissor.
- Processamento de pagamentos através da DEUNA - Processamos o pagamento com as respetivas prestações diretamente com a PSP.
- Transações utilizando um
card_idserão processados sem a necessidade de fornecer o Valor de Verificação do Cartão (CVV), graças à tokenização com o PSP. - Antes de aceitar pagamentos na América Latina, é necessária uma entidade legal e um adquirente no país de operação
Análise Antifraude
- PayU oferece recursos antifraude para manter altas taxas de aprovação e estornos controlados
- As transações suspeitas identificadas pela PayU permanecerão no status Deuna como Processando pagamento enquanto a PayU realiza uma revisão manual delas.
- Assim que PayU concluir sua análise, Deuna alterará o status do pagamento de Processando para Processado ou Negado e informará o comerciante sobre esta atualização via webhook.
- Esta funcionalidade requer informações importantes como:
- Impressão digital do dispositivo. Siga isto seção para obter etapas detalhadas para obtê-lo.
- Comércio eletrônico: detalhes de faturamento, frete e companhia aérea
- Pedidos de companhias aéreas: PNR, informações de itinerário, detalhes do passageiro
- Da mesma forma, PayU exige o sessionID do comprador no site do comerciante. PayU espera o Cookie de Sessão do Comerciante (muitas vezes chamado apenas de “ID de Sessão”). Este é o identificador exclusivo que seu site atribui a um visitante para acompanhar seu carrinho de compras ou estado de login.
- O nome depende da tecnologia com a qual seu site foi construído:
- PHP/Magento/WooCommerce: PHPSESSID
- Java/Spring: JSESSIONID
- Node.js: connect.sid
- ASP.NET: ASP.NET_SessionId
- VTEX/Shopify: Frequentemente chamado de checkout, cart_token ou _shopify_s.
- Onde posso encontrar o sessionID no meu site?
- Selecione Inspecionar e em aplicativo ou armazenamento, encontre a pasta de cookies
- Selecione seu site e procure o nome que corresponde à sua tecnologia (por exemplo, PHPSESSID).
- A string dentro da coluna Valor é exatamente o que você precisa enviar (mais comumente um UUID)
- O nome depende da tecnologia com a qual seu site foi construído:
- Como enviar essas informações para Deuna?
-
- Comprar v2
- metadata.additional_data.cookie
- Comprar v2
- Opção 1: anti_fraud_info.cookies[].value
- Opção 2: metadata.additional_data.cookie
- Comprar v2