Getnet SEP | DEUNA Docs

Sur cette page

Intégrer Getnet SEP
Considérations particulières et limites
Ressources de test

Cette page fournit un guide pour intégrer Getnet SEP à DEUNA.

Opérations prises en charge

L'intégration de Getnet SEP 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

Méthodes de paiement prises en charge

Cartes

Visa
Carte Master
Dîners

Pays et devises actifs

AR (ARS)
MX (MXN)
CL (CLP)
BR (BRL, USD)

Exigences

Contactez votre représentant Getnet SEP et demandez les informations d'identification Getnet SEP suivantes :

Client ID
Secret client

Intégrer Getnet SEP#

Intégrez Getnet SEP dans DEUNA.

1. Recherchez Getnet SEP dans Connexions

Recherchez Getnet SEP dans l’administrateur DEUNA.

Connectez-vous à votre session d'administration DEUNA.
Cliquez Connexions.
Sur le résultat Getnet, cliquez sur Se connecter.

Exemple interactifUtilise des données fictives et n’effectue aucune requête API.

Paiements

Connexions

Découvrez et gérez les intégrations de paiement, de portefeuille et antifraude.

Acme LATAM · Production

Rechercher des connexions

Connexions	Type	Statut
Adyen	Passerelle de paiement	Connectée
Worldpay	Passerelle de paiement	Connectée
PayPal	Moyen de paiement	Connectée
Mercado Pago	Moyen de paiement	Non connectée
Riskified	Moteur antifraude	Non connectée

2. Configurez Getnet SEP dans votre boutique

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 Client ID entrez l’ID client de Getnet SEP.
- Dans Secret client entrez le secret client de Getnet SEP.
- Dans Chaîne entrer DN (toujours vers SBX ou PROD)
Choisissez le type d'opération que vous souhaitez effectuer :
- Achat
- Autorisation
Choisissez si vous souhaitez activer la 3DS.
Cliquez Se connecter.

Une fois les étapes terminées, vous verrez un message de réussite.

3. Traitez les paiements avec Getnet SEP

Vous verrez la connexion Getnet SEP dans l'onglet Connexions actives .

À partir de ce moment, vous pouvez désormais traiter les transactions avec Getnet SEP 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": "03",
            "expiry_year": "2030",
            "card_holder_dni": "",
            "card_holder": "Omar Guzhnay",
            "card_number": "4772133007520635",
            "card_cvv": "737",
            "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": "+5930962917328",
            "installments": 1
        }
    },
    "order": {
        "order_id": "9517cc3e-ef63-478d-88cc-9a72f690bcdc",
        "currency": "MXN",
        "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": "MXN",
                    "currency_symbol": "$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "MXN",
                    "currency_symbol": "$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "MXN",
                    "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": "MXN",
                    "currency_symbol": "$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "MXN",
                    "currency_symbol": "$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "MXN",
                    "currency_symbol": "$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30000,
        "total_tax_amount": 30000,
        "total_amount": 230000,
        "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": "MIGUEL HIDALGO",
            "state_name": "CIUDAD DE MÉXICO",
            "country_code": "MX",
            "identity_document": "1205973330",
            "identity_document_type": "",
            "phone": "+5930962917328",
            "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"
                    }
                }
            ]
        }
    }
}

Exemple de demande avec options de plan de versement

JSON

{
    "transaction_id": "32e61625-6586-4392-8d03-1745901bd9e6",
    "amount": 230009,
    "device_id": "2128b31d-c7c1-46d1-83fa-3fc545dbbeb4",
    "order_token": "4a64f32b-5086-4199-9e0e-c9ec1f54e93a",
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "01",
            "expiry_year": "2029",
            "card_holder_dni": "",
            "card_holder": "Omar Guzhnay",
            "card_number": "4772133007520635",
            "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": "+5930962917328",
            "installment": {
                "plan_option_id": "ff1c4600-f3ef-4a9e-918a-95468ac1216a"
            }
            
        }
    }
}

Considérations particulières et limites#

Adresse de facturation

Les transactions nationales acquises par Getnet SEP en AR, MX, CL et BR doivent inclure les informations suivantes sur l'acheteur dans la demande d'autorisation :

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Cela fait suite à la réglementation locale visant à retenir la taxe dans la province de l'acheteur. Lorsque ces données ne sont pas fournies, Getnet SEP retient la taxe en fonction de l'emplacement du commerçant.

Liste des codes ISO par pays :

Code de province ISO de MX	Province Nom de MX
MX-AGU	Aguascalientes
MX-BCN	Basse-Californie
MX-BCS	Basse-Californie du Sud
MX-CAM	Campeche
MX-CHP	Chiapas
MX-CHH	Chihuahua
MX-CMX	Ville de Mexique
MX-COA	Coahuila
MX-COL	Colima
MX-DUR	Durango
MX-MEX	État de Mexique
MX-GUA	Guanajuato
MX-GRO	Guerrero
MX-HID	Hidalgo
MX-JAL	Jalisco
MX-MIC	Michoacán
MX-MOR	Morelos
MX-NAY	Nayarit
MX-NLE	Nouveau Léon
MX-OAX	Oaxaca
MX-PUE	Puebla
MX-QUE	Querétaro
MX-ROO	Quintana Roo
MX-SLP	San Luis Potosi
MX-SIN	Sinaloa
MX-SON	Sonora
MX-TAB	Tabasco
MX-TAM	Tamaulipas
MX-TLA	Tlaxcala
MX-VER	Veracruz
MX-YUC	Yucatán
MX-ZAC	Zacatecas

Code de province ISO de AR	Province Nom du RA
AR-C	CABA
AR-P	Formose
AR-D	San Luis
AR-E	Entre Ríos
AR-L	La Pampa
AR-A	Salta
AR-H	Chaco
AR-U	Chubut
AR-Y	Jujuy
AR-Z	Sainte-Cruz
AR-K	Catamarca
AR-X	Cordoue
AR-F	La Rioja
AR-G	Santiago de l'Estero
AR-J	Saint-Jean
AR-M	Mendoza
AR-N	Missions
AR-Q	Neuquén
AR-R	Río Negro
AR-V	Terre de Feu
AR-B	Buenos Aires
AR-S	Santa Fé
AR-T	Tucumán
AR-W	Corrientes

Code de province ISO de CL	Province Nom du CL
CL-RM	Région métropolitaine de Santiago
CL-AN	Antofagasta
CL-AP	Arica et Parinacota
CL-AT	Atacama
CL-AI	Aysén
CL-BI	Biobio
CL-CO	Coquimbo
CL-AR	L'Araucanie
CL-LL	Los Lacs
CL-LR	Los Rios
CL-MA	Magallanes
CL-ML	Maulé
CL-NB	Ñuble
CL-LI	O'Higgins
CL-TA	Tarapacá
CL-VS	Valparaiso

Code de province ISO de BR	Province Nom du BR
BR-SP	São Paulo
BR-RJ	Rio de Janeiro
BR-AC	Acre
BR-AL	Alagoas
BR-AP	Amapa
BR-AM	Amazonie
BR-BA	Bahía
BR-CE	Ceara
BR-DF	District Fédéral
BR-ES	Esprit Saint
BR-GO	Goias
BR-MA	Maranhão
BR-MT	Mato Grosso
BR-MS	Mato Grosso du Sud
BR-MG	Minas Gerais
BR-PA	Para
BR-PB	Paraíba
BR-PR	Paraná
BR-PE	Pernambouc
BR-PI	Piauí
BR-RN	Rio Grande do Norte
BR-RS	Rio Grande do Sul
BR-RO	Rondonia
BR-RR	Roraima
BR-SC	Sainte Catherine
BR-SE	Sergipe
BR-TO	TocantinsCABA

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.
Remboursements partiels, c'est-à-dire un montant inférieur à la valeur totale de la transaction.
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 :
1. 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.
2. Traitement des paiements via DEUNA - Nous traitons le paiement avec les versements respectifs directement avec le PSP.
Avant d'accepter des paiements en Amérique latine, une personne morale et un acquéreur dans le pays d'exploitation sont requis.
Le acquirer_transaction_id Le champ est renvoyé dans la réponse de paiement et contient l'identifiant de transaction attribué par l'acquéreur. DEUNA capture cette valeur de GetNet SEP et l'expose de manière cohérente sur toutes les surfaces de transaction, y compris les réponses API, les webhooks et les détails des transactions. Utilisez cet identifiant lors du rapprochement des transactions, du dépannage des problèmes de paiement ou de l'interaction directe avec l'acquéreur concernant une transaction spécifique.

Ressources de test#

Collection Postman

Demandez la collection Getnet SEP Postman actuelle à votre équipe d'intégration DEUNA avant de tester les API.

Cartes de test

Marque	Flux	Pays	Numéro de carte	Mois d'expiration	Année d'expiration	CVV
Maître	Approuvé	MX	5155901222260000	12	2030	123
Visa	Approuvé	CL	4042050000001005	12	2030	123
Maître	Approuvé	BR	5155901222280001	12	2030	123
Visa	Approuvé	AR	4042050000001005	12	2030	123
Maître	Approuvé 3DS	*ALL	5204740000001002	12	2030	123
Maître	Approuvé 3DS	*ALL	5200000000002151	12	2030	123

Scénarios de tests de rejet

Marque	Flux	Pays	Numéro de carte	Mois d'expiration	Année d'expiration	CVV
Maître	Rejeté	MX, CL, AR	5155901222280001	12	2030	123

Montant	Refuser
8888.01	Carte expirée
8888.02	Fonds insuffisants
8888.03	Dépasse la limite de retrait
8888.05	Numéro de carte invalide