Getnet SEP | DEUNA Docs

In questa pagina

Integrare Getnet SEP
Considerazioni e limitazioni speciali
Testare le risorse

Questa pagina fornisce una guida per integrare Getnet SEP con DEUNA.

Operazioni supportate

L'integrazione di Getnet SEP 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

Metodi di pagamento supportati

Carte

Visto
Mastercard
Diners

Paesi attivi e valute

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

Requisiti

Contatta il tuo rappresentante Getnet SEP e richiedi le seguenti credenziali Getnet SEP:

Client ID
Segreto del cliente

Integrare Getnet SEP#

Integra Getnet SEP in DEUNA.

1. Cercare Getnet SEP in connessioni

Cerca Getnet SEP nell'Admin DEUNA.

Accedi alla tua sessione di amministrazione DEUNA.
Cliccare su Collegamenti.
Sul risultato Getnet, fare clic Collegamento.

Esempio interattivoUsa dati di esempio e non effettua richieste API.

Pagamenti

Connessioni

Scopri e gestisci le integrazioni di pagamento, wallet e antifrode.

Acme LATAM · Produzione

Cerca connessioni

Connessioni	Tipo	Stato
Adyen	Gateway di pagamento	Connessa
Worldpay	Gateway di pagamento	Connessa
PayPal	Metodo di pagamento	Connessa
Mercado Pago	Metodo di pagamento	Non connessa
Riskified	Motore antifrode	Non connessa

2. Configura Getnet SEP 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 Client ID inserire l’ID client di Getnet SEP.
- In Segreto del cliente entrare nel Segreto del Cliente di Getnet SEP.
- In Canale entrare DN (sempre a SBX o PROD)
Scegli il tipo di operazione che vuoi eseguire:
- Acquisto
- Autorizzazione
Scegliere se si desidera attivare 3DS.
Cliccare su Collegamento.

Una volta completate i passaggi, vedrete un messaggio di successo.

3. Elaborare pagamenti con Getnet SEP

Vedrete la connessione Getnet SEP all'interno della scheda Connessioni attive.

Da questo punto in poi, è ora possibile elaborare le transazioni con Getnet SEP 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": "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"
                    }
                }
            ]
        }
    }
}

Richiesta con Opzioni Piano di Installazione Esempio

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"
            }
            
        }
    }
}

Considerazioni e limitazioni speciali#

Indirizzo di fatturazione

Le transazioni nazionali acquistate da Getnet SEP in AR, MX, CL e BR devono includere le seguenti informazioni sull'acquirente nella richiesta di autorizzazione:

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Ciò segue la normativa locale per trattenere l'imposta nella provincia del commerciante. Quando questi dati non vengono forniti, Getnet SEP ritiri l'imposta sulla base della posizione del commerciante.

Elenco dei codici ISO per paese:

Codice provinciale ISO di MX	Provincia Nome di MX
MX-AGU	Aguascalientes
MX-BCN	Baja California
MX-BCS	Baja California Sur
MX-CAM	Campeche
MX-CHP	Chiapas
MX-CHH	Chihuahuahua
MX-CMX	Ciudad de México
MX-COA	Coahuila
MX-COL	Colima
MX-DUR	Durango
MX-MEX	Estado de México
MX-GUA	Guanajuato
MX-GRO	Guerrero
MX-HID	Hidalgo
MX-JAL	Jalisco
MX-MIC	Michoacán
MX-MOR	Morelos
MX-NAY	Nayarit
MX-NLE	Nuevo León
MX-OAX	Oaxaca
MX-PUE	Puebla
MX-QUE	Querétaro
MX-ROO	Quintana Roo
MX-SLP	San Luis Potosí
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

Codice provinciale ISO di AR	Provincia Nome di AR
AR-C	CABA
AR-P	Formosa
AR-D	San Luis
AR-E	Entre Rios
AR-L	La Pampa
AR-A	Salta
AR-H	Chaco
AR-U	Chubut
AR-Y	Jujuy
AR-Z	Santa Cruz
AR-K	Catamarca
AR-X	Cordova
AR-F	La Rioja
AR-G	Santiago del Estero
AR-J	San Juan
AR-M	Mendoza
AR-N	Misiones
AR-Q	No.
AR-R	Rio Negro
AR-V	Tierra del Fuego
AR-B	Buenos Aires
AR-S	Santa Fe
AR-T	Tucumán
AR-W	Corrientes

Codice provinciale ISO di CL	Provincia Nome di CL
CL-RM	Región Metropolitana di Santiago
CL-AN	Antofagasta
CL-AP	Arica y Parinacota
CL-AT	Atacama
CL-AI	Aysén
CL-BI	Biobiteo
CL-CO	Coquillo
CL-AR	La città di Las Vegas
CL-LL	Los Lagos
CL-LR	Los Ríos
CL-MA	Magallanes
CL-ML	Maule
CL-NB	- Che cosa?
CL-LI	O'Higgins
CL-TA	Tarapacá
CL-VS	Valparaí

Codice provinciale ISO di BR	Provincia Nome di BR
BR-SP	San Paolo
BR-RJ	Rio de Janeiro
BR-AC	Acre
BR-AL	Alagos
BR-AP	Amapá
BR-AM	Amazzoni
BR-BA	Bahia
BR-CE	Cena
BR-DF	Distrito Federale
BR-ES	Espírito Santo
BR-GO	Goiás
BR-MA	Maranhão
BR-MT	Mato Grosso
BR-MS	Mato Grosso do Sul
BR-MG	Minas Gerais
BR-PA	Pará
BR-PB	Paraíba
BR-PR	Paraná
BR-PE	Pernambuco
BR-PI	Piauí
BR-RN	Rio Grande do Norte
BR-RS	Rio Grande do Sul
BR-RO	Rondônia
BR-RR	Roraima
BR-SC	Santa Catarina
BR-SE	Sergipente
BR-TO	TocantinsCABA

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.
Rimborso parziale, che significa un importo inferiore al valore totale delle transazioni.
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:
1. 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.
2. Elaborazione dei pagamenti tramite DEUNA - Elaboriamo il pagamento con le rispettive rate direttamente con il PSP.
Prima di prendere i pagamenti in America Latina è necessaria una entità giuridica e un acquirente nel paese di funzionamento.
Il acquirer_transaction_id campo viene restituito nella risposta di pagamento e contiene l'identificatore di transazione assegnato dall'acquirente. DEUNA cattura questo valore da GetNet SEP e lo espone costantemente su tutte le superfici di transazione, comprese le risposte API, webhooks e dettagli delle transazioni. Utilizzare questo identificatore quando si riconciliano le transazioni, risolvere problemi di pagamento, o interagire direttamente con l'acquirente per quanto riguarda una transazione specifica.

Testare le risorse#

Raccolta Postman

Richiedi la collezione di Getnet SEP Postman del tuo team di integrazione DEUNA prima di testare le API.

Testare le carte

Marca	Flusso	Paese	Numero di carta	Mese di scadenza	Anno di scadenza	CVV
Maestro	Approvazione	MX	5155901222260000	12	2030	123
Visto	Approvazione	CL	4042050000001005	12	2030	123
Maestro	Approvazione	BR	5155901222280001	12	2030	123
Visto	Approvazione	AR	4042050000001005	12	2030	123
Maestro	3DS approvato	*ALL	5204740000001002	12	2030	123
Maestro	3DS approvato	*ALL	5200000000002151	12	2030	123

Scenari di prova di iniezione

Marca	Flusso	Paese	Numero di carta	Mese di scadenza	Anno di scadenza	CVV
Maestro	Rifiutata	MX, CL, AR	5155901222280001	12	2030	123

Importo	Declinazione
8888.01	Carta scaduta
8888.02	Fondi insufficienti
8888.03	Limite di prelievo
8888.05	Numero della carta non valida