Payer
Cette page fournit un guide pour intégrer PayU avec DEUNA.
Opérations prises en charge
L'intégration de PayU dans votre stratégie de paiement avec DEUNA vous permet d'effectuer les opérations suivantes :
- Autorisation
- Capture complète
- Captures partielles
- Achat (capturé automatiquement)
- Remboursement partiel (jusqu'à un par commande)
- Remboursement intégral
- Vide
- Acompte
- 3DS DEUNA
- 3DS avec PSP
Méthodes de paiement prises en charge
Cartes
- Visa
- Carte Master
- Dîners
- Amex
Pays et devises actifs
- Colombie (COL)
- Argentine (ARS)
- Perú (PEN, USD)
- Panama (USD)
Exigences
Communiquez avec votre représentant PayU et demandez les justificatifs suivants :
- Vos titres de compétence PayU
Intégrer le salaire#
Après avoir cherché PayU dans Connections, vous devez configurer PayU dans votre boutique.
1. Configurez PayU dans votre magasin
Dans Connexions, une fenêtre comme celle-ci s'ouvrira :
- Saisissez les informations d'identification suivantes :
- Dans Nom entrez un nom pour référencer les informations d'identification.
- Dans Devise sélectionnez la devise du processeur marchand disponible.
- Dans Merchant ID Entrez l'identifiant de Merchat PayU.
- Dans Clé API Entrez la clé API PayU.
- Dans Connexion à l'API saisir l'API de PayUs Login.
- Dans Account ID entrez l'ID de compte PayU.
- Las credenciales ingresadas deben ser compatibles avec la selectción
- Choisissez le type d'opération que vous souhaitez effectuer :
- Achat
- Autorisation
- Choisissez si vous voulez activer Remboursements partiels multiples.
- Choisissez si vous voulez activer 3DS avec DEUNA ou PSP
- Cliquez Se connecter.
Une fois les étapes terminées, vous verrez un message de réussite.
3. Traiter les paiements avec PayU
Ensuite, vous pourrez voir votre connexion PayU dans l'onglet Connexions actives.
À partir de ce moment, vous pouvez maintenant traiter les transactions avec PayU via DEUNA.
Exemple d'achat 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"
}
}
]
}
}
}Considérations particulières et limites#
Adresse de facturation
Les transactions intérieures acquises par PayU doivent inclure les opérations de l'acheteur billing_address.zipcode, billing_address.state-name, billing_address.country_code dans la demande d'autorisation. Cette mesure fait suite à la réglementation locale de retenir la taxe dans la province du client. Lorsque ces données ne sont pas fournies, PayU retient la taxe en fonction de l'emplacement du commerçant.
Soumettre les codes provinciaux ISO ou locaux (COMARB) (mais pas les deux)
| Code de la province COMARB | Code de la province ISO | Nom de la province |
|---|---|---|
| 901 | AR-C | CABA |
| 909 | AR-P | Formose |
| 919 | AR-D | San Luis |
| 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 | Sainte-Cruz |
| 903 | AR-K | Catamarca |
| 904 | AR-X | Cordoue |
| 912 | AR-F | La Rioja |
| 922 | AR-G | Santiago de l'Estero |
| 918 | AR-J | Saint-Jean |
| 913 | AR-M | Mendoza |
| 914 | AR-N | Missions |
| 915 | AR-Q | Neuquén |
| 916 | AR-R | Río Negro |
| 923 | AR-V | Terre de Feu |
| 902 | AR-B | Buenos Aires |
| 921 | AR-S | Santa Fé |
| 924 | AR-T | Tucumán |
| 905 | AR-W | Corrientes |
Considérations supplémentaires
- Code de devise : Spécifie le code de devise (ISO 4217) du pays concerné.
- Code pays : spécifie le Codes pays ISO
- Le nombre de versements est validé par rapport au nombre maximum de versements convenu avec l'acquéreur.
- Un paiement qui est AUTHORIZED peut être capturé.
- Une capture partielle peut être effectuée si nécessaire.
- Chaque paiement autorisé permet une capture partielle ou totale.
- Il est recommandé de capturer une commande dans les 5 jours suivant l'autorisation pour éviter son expiration.
- Un remboursement ne peut être demandé qu'après qu'un paiement ait atteint le CAPTURED status.
- Les remboursements ne peuvent pas dépasser le montant initial capturé, mais un ou plusieurs remboursements partiels du montant capturé peuvent être effectués.
- Plusieurs remboursements partiels peuvent être envoyés par commande.
- Les remboursements partiels, c'est-à-dire un montant inférieur à la valeur transactionnelle totale, peuvent être appliqués après règlement (mi-nuit), à partir d'une période T+2.
- Un paiement ne peut être annulé (annulé) qu'après avoir atteint le AUTHORIZED status.
- L'annulation n'est plus possible une fois le paiement atteint le CAPTURED status.
- Une annulation complète (annulée) peut être envoyée par commande.
- Les versements peuvent être personnalisés pour offrir un nombre spécifique de paiements et peuvent inclure des options sans intérêt ou des frais définis par le commerçant. Comment ça marche :
- Le client choisit les versements - Grâce à l'API Get Installment, le client pourra obtenir les options de paiement échelonnées disponibles. La réponse comprendra le numéro du versement ainsi que le montant du versement hors intérêts. Ce service ne renverra pas de taux d'intérêt, car il s'agit d'un accord direct avec l'acquéreur ou l'émetteur.
- Traitement des paiements via DEUNA - Nous traitons le paiement avec les versements respectifs directement avec le PSP.
- Opérations utilisant une
card_idsera traité sans avoir besoin de fournir la valeur de vérification de carte (CVV), grâce à la tokenisation avec le PSP. - Avant de procéder à des paiements en Amérique latine, une personne morale et un acquéreur dans le pays d'opération sont requis.
Analyse antifraude
- PayU offre des fonctionnalités antifraude pour maintenir des taux d'approbation élevés et des recharges contrôlées
- Les opérations suspectes identifiées par PayU resteront à Deuna comme traitement de l'état de paiement tandis que PayU effectue un examen manuel de ces opérations.
- Une fois l'analyse terminée, Deuna changera le statut de paiement du traitement au traitement ou au refus, et informera le marchand de cette mise à jour via webhook.
- Cette fonctionnalité nécessite des informations clés, à savoir:
- Empreinte du périphérique. Suivez ceci section pour les étapes détaillées pour l'obtenir.
- Commerce électronique: facturation, expédition et détails de la compagnie aérienne
- Commandes aériennes: PNR, informations sur l'itinéraire, détails passagers
- De même, PayU exige le sesionID de l'acheteur sur le site web du marchand. PayU s'attend à ce que le cookie de session Merchant (souvent appelé "ID de session"). C'est l'identificateur unique que votre site Web assigne à un visiteur pour garder une trace de son panier ou de son état de connexion.
- Le nom dépend de la technologie avec laquelle votre site est construit :
- PHP / Magento / WooCommerce: PHPSESSID
- Java / Printemps: JSESSIONID
- Node.js: connect.sid
- ASP.NET: ASP.NET SessionId
- VTEX / Shopify: Souvent nommé caisse, cart token, ou shopify s.
- Où puis-je trouver le sessionID dans mon site web?
- Sélectionnez Inspecter et sous application ou stockage, trouvez le dossier cookies
- Sélectionnez votre site Web et recherchez le nom qui correspond à votre technologie (par exemple PHPSESSID).
- La chaîne de caractères à l'intérieur de la colonne Valeur est exactement ce que vous devez envoyer (le plus souvent un UUID)
- Le nom dépend de la technologie avec laquelle votre site est construit :
- Comment envoyer ces informations à Deuna?
-
- Acheter la v2
- metadata.additional_data.cookie
- Acheter la v2
- Option 1: anti fraude info.cookies[].valeur
- Option 2: métadonnées.supplémental data.cookie
- Acheter la v2