Pays
Questa pagina fornisce una guida per integrare PayU con DEUNA.
In questa pagina
Operazioni supportate
L'integrazione PayU nella vostra strategia di pagamento con DEUNA consente di eseguire le seguenti operazioni:
- Autorizzazione
- Cattura completa
- Acquisizioni parziali
- Acquisto (auto-captured)
- Rimborso parziale (fino a uno per ordine)
- rimborso completo
- Void
- Installazione
- 3DS DEUNA
- 3DS con PSP
Metodi di pagamento supportati
Carte
- Visto
- Mastercard
- Diners
- Amex
Paesi attivi e valute
- Colombia (COL)
- Argentina (ARS)
- Perú (PEN, USD)
- Panama (USD)
Requisiti
Contatta il tuo rappresentante PayU e richiedi le seguenti credenziali:
- Le credenziali PayU
Integrare PayU#
Dopo aver cercato PayU in Connections, è necessario configurare PayU nel tuo negozio.
1. Configura PayU nel tuo negozio
In Connessioni, una finestra come la seguente si aprirà:
- Inserisci le seguenti credenziali:
- In Nome inserire un nome per fare riferimento alle credenziali.
- In Valuta selezionare la valuta del processore di Merchant disponibile.
- In Merchant ID entrare nel PayU’s Merchat ID.
- In Chiave API inserire la chiave API di PayU.
- In Login API inserire il login API di PayU.
- In Account ID inserire l’ID conto della PayU.
- Las credenciales ingresadas deben ser compatibiles con la selección
- Scegli il tipo di operazione che vuoi eseguire:
- Acquisto
- Autorizzazione
- Scegli se vuoi attivare Rimborsi multipli parziali.
- Scegli se vuoi attivare 3DS con DEUNA o PSP
- Cliccare su Collegamento.
Una volta completate i passaggi, vedrete un messaggio di successo.
3. Elaborare pagamenti con PayU
Successivamente, sarà possibile vedere la connessione PayU all'interno della scheda Connessioni attive.
Da questo punto in poi, è ora possibile elaborare le transazioni con PayU attraverso DEUNA.
Acquisto v2 esempio
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"
}
}
]
}
}
}Considerazioni e limitazioni speciali#
Billing adress
Le transazioni nazionali acquistate dalla PayU devono includere il compratore billing_address.zipcode, billing_address.state-name, billing_address.country_code nella richiesta di autorizzazione. Ciò segue la normativa locale per trattenere l'imposta nella provincia del commerciante. Quando questi dati non vengono forniti, PayU ritirizzo fiscale basato sulla posizione del commerciante.
Inviare i codici della provincia ISO o locale (COMARB) (ma non entrambi)
| Codice provinciale COMARB | Codice provinciale ISO | Nome della Provincia |
|---|---|---|
| 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 | Cordova |
| 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 | No. |
| 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 |
Considerazioni aggiuntive
- Codice valuta: Specifica il codice valuta (ISO 4217) per il paese in questione.
- Codice paese: Specifica il Codici di Paese ISO
- Il numero di rate viene convalidato rispetto al numero massimo di rate concordate con l'acquirente.
- Un pagamento che è AUTHORIZED può essere catturato.
- Una cattura parziale può essere eseguita se necessario.
- Ogni pagamento autorizzato consente una cattura parziale o completa.
- Si raccomanda di catturare un ordine entro 5 giorni dall'autorizzazione per evitare la scadenza.
- Un rimborso può essere richiesto solo dopo un pagamento raggiunge il CAPTURED status.
- I rimborsi non possono superare l'importo acquisito originale, ma si possono effettuare uno o più rimborsi parziali dell'importo catturato.
- Il rimborso parziale può essere inviato per ordine.
- I rimborsi parziali, che significa un importo inferiore al valore totale delle transazioni, possono essere applicati dopo la liquidazione (mezzo notte), a partire da un periodo T+2.
- Un pagamento può essere annullato (Void) solo dopo che raggiunge il AUTHORIZED status.
- La cancellazione non è più possibile una volta che il pagamento raggiunge il CAPTURED status.
- Cancellazione completa (void) può essere inviata per ordine.
- Le rate possono essere personalizzate per offrire un numero specifico di pagamenti e possono includere opzioni senza interessi o oneri definiti dal commerciante. Come funziona:
- Il cliente sceglie le rate - Attraverso l'API di installazione di Get il cliente sarà in grado di ottenere le opzioni di pagamento di installazione disponibili. La risposta includerà il numero di installazione insieme all'importo di installazione, escluso l'interesse. Questo servizio non restituirà i tassi di interesse, in quanto è un accordo diretto con l'acquirente o l'emittente.
- Elaborazione dei pagamenti tramite DEUNA - Elaboriamo il pagamento con le rispettive rate direttamente con il PSP.
- Transazioni che utilizzano un
card_idsarà elaborato senza la necessità di fornire il valore di verifica della carta (CVV), grazie alla tokenizzazione con il PSP. - Prima di prendere i pagamenti in America Latina è necessaria una entità giuridica e un acquirente nel paese di funzionamento
Analisi Antifraud
- PayU offre funzionalità antifraud per mantenere alti tassi di approvazione e chargeback controllati
- Le transazioni sospette identificate da PayU rimarranno a Deuna come stato di pagamento del trattamento mentre PayU esegue una loro revisione manuale.
- Una volta che PayU termina la loro analisi, Deuna cambierà lo stato di pagamento da Processing a Processed o Denied, e informerà il commerciante di questo aggiornamento via webhook.
- Questa funzionalità richiede informazioni chiave come:
- Impronte di dispositivo. Seguite questo sezione per i passaggi dettagliati per ottenerlo.
- Ecommerce: fatturazione, spedizione e dettagli aerei
- Ordini Airlne: PNR, informazioni sull'itinerario, dettagli del passeggero
- Allo stesso modo, PayU richiede sesionID del cliente nel sito del commerciante. PayU si aspetta il Cookie di sessione Merchant (spesso chiamato "Session ID"). Questo è l'identificatore unico che il tuo sito assegna a un visitatore per tenere traccia del loro carrello o stato di login.
- Il nome dipende dalla tecnologia che il tuo sito web è costruito con:
- PHP / Magento / WooCommerce: PHPSESSID
- Java / Primavera: JSESSIONID
- Node.js: collegare.sid
- ASP.NET: ASP.NET SessionId
- VTEX / Shopify: Spesso nominato checkout, cart token, o shopify s.
- Dove posso trovare il sessionID nel mio sito web?
- Selezionare Ispezione e sotto applicazione o archiviazione, trovare la cartella dei cookie
- Seleziona il tuo sito web e cerca il Nome che corrisponde alla tua tecnologia (ad esempio PHPSESSID).
- La stringa all'interno della colonna Valore è esattamente ciò che è necessario inviare (più comunemente un UUID)
- Il nome dipende dalla tecnologia che il tuo sito web è costruito con:
- Come inviare queste informazioni a Deuna?
-
- Acquisto v2
- metadata.additional_data.cookie
- Acquisto v2
- Opzione 1: anti fraud info.cookies[].value
- Opzione 2: metadata.additional data.cookie
- Acquisto v2