Getnet SEP

This page provides a guide to integrate Getnet SEP with DEUNA.

Supported Operations

Getnet SEP integration in your payment strategy with DEUNA allows you to perform the following operations:

Authorization
Full capture
Partial captures
Purchase (auto-captured)
Partial refund (up to one per order)
Full refund
Void
Installment
3DS DEUNA

📘
Online multiple partial captures and refunds can be enabled through configuration. Contact DEUNA to activate these features if required

Supported Payment Methods

Cards

Visa
Mastercard
Diners

Active countries and currencies

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

Requirements

Contact your Getnet SEP representative and request the following Getnet SEP credentials:

Client ID
Client Secret

📘
Make sure your account is properly configured on the Getnet SEP side.

Integrate Getnet SEP

Integrate Getnet SEP in DEUNA.

1. Look for Getnet SEP in Connections

Search for Getnet SEP in the DEUNA Admin.

Log in to your DEUNA Admin session.
Click Connections.
On the Getnet result, click Connect.

2. Configure Getnet SEP in your store

In Connections, a window like the following will open:

Enter the following credentials:
- In Name enter a name to reference the credential.
- In Currency select the Currency of Merchant Processor available.
- In Client ID enter the Getnet SEP’s Client ID.
- In Client Secret enter the Getnet SEP’s Client Secret.
- In Channel enter DN (always to SBX or PROD)
Choose the type of operation you want to perform:
- Purchase
- Authorization
Choose if you want to activate 3DS.
Click Connect.

Once you complete the steps, you will see a success message.

3. Process payments with Getnet SEP

You will see the Getnet SEP connection within the Active Connections tab.

From this point on, you can now process transactions with Getnet SEP through DEUNA.

Purchase v2 example

{
    "payer_info": {
        "email": "[email protected]"
    },
    "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": "[email protected]",
            "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": "[email protected]",
                        "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": "[email protected]",
                        "phone": "+12125551234",
                        "date_of_birth": "1990-05-15"
                    }
                }
            ]
        }
    }
}

Request with Installment Plan Options Example

{
    "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": "[email protected]"
    },
    "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"
            }
            
        }
    }
}

Special considerations and limitations

Billing address

Domestic transactions acquired by Getnet SEP in AR, MX, CL, and BR must include the following shopper information in the authorization request:

billing_address.zipcode
billing_address.state_name
billing_address.country_code

This follows the local regulation to withhold tax in the shopper's province. When this data is not supplied, Getnet SEP withholds tax based on the merchant location.

List of ISO codes by country:

Province code ISO of MX	Province Name of MX
MX-AGU	Aguascalientes
MX-BCN	Baja California
MX-BCS	Baja California Sur
MX-CAM	Campeche
MX-CHP	Chiapas
MX-CHH	Chihuahua
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

Province code ISO of AR	Province Name of 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	Cordoba
AR-F	La Rioja
AR-G	Santiago del Estero
AR-J	San Juan
AR-M	Mendoza
AR-N	Misiones
AR-Q	Neuquén
AR-R	Rio Negro
AR-V	Tierra del Fuego
AR-B	Buenos Aires
AR-S	Santa Fe
AR-T	Tucumán
AR-W	Corrientes

Province code ISO of CL	Province Name of CL
CL-RM	Región Metropolitana de Santiago
CL-AN	Antofagasta
CL-AP	Arica y Parinacota
CL-AT	Atacama
CL-AI	Aysén
CL-BI	Biobío
CL-CO	Coquimbo
CL-AR	La Araucanía
CL-LL	Los Lagos
CL-LR	Los Ríos
CL-MA	Magallanes
CL-ML	Maule
CL-NB	Ñuble
CL-LI	O'Higgins
CL-TA	Tarapacá
CL-VS	Valparaíso

Province code ISO of BR	Province Name of BR
BR-SP	São Paulo
BR-RJ	Rio de Janeiro
BR-AC	Acre
BR-AL	Alagoas
BR-AP	Amapá
BR-AM	Amazonas
BR-BA	Bahia
BR-CE	Ceará
BR-DF	Distrito Federal
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	Sergipe
BR-TO	TocantinsCABA

Currency Code: Specifies the currency (ISO 4217) code for the relevant country.
Country Code: Specifies the ISO Country Codes
The number of installments is validated against the maximum number of installments agreed with the acquirer.
A payment that is AUTHORIZED can be captured.
A partial capture can be performed if necessary.
Each authorized payment allows for either a partial or full capture.
It is recommended to capture an order within 5 days of the authorization to prevent expiration.
A refund can be requested only after a payment reaches the CAPTURED status.
Refunds cannot exceed the original captured amount, but one or more partial refunds of the captured amount can be performed.
Multiple partial refund can be sent per order.
Partial refunds, meaning an amount less than the total transaction value.
A payment can be canceled (Void) only after it reaches the AUTHORIZED status.
Cancellation is no longer possible once the payment reaches the CAPTURED status.
Full cancel (void) can be sent per order.
The installments can be customized to offer a specific number of payments and can include interest-free options or charges defined by the merchant. How it Works:
1. The customer chooses the installments - Through the Get Installment API the customer will be able to obtain the available installment payment options. The response will include the installment number along with the installment amount excluding interest. This service will not return interest rates, as it is a direct agreement with the acquirer or issuer.
2. Payment processing through DEUNA - We process the payment with the respective installments directly with the PSP.
Before taking payments in Latin America a legal entity and an acquirer in the country of operation are required

Testing Resources

Postman collection

Refer to the GETNET Postman collection for testing the Getnet SEP APIs.

Testing cards

Brand	Flow	Country	Card number	Expiry month	Expiry year	CVV
Master	Approved	MX	5155901222260000	12	2030	123
Visa	Approved	CL	4042050000001005	12	2030	123
Master	Approved	BR	5155901222280001	12	2030	123
Visa	Approved	AR	4042050000001005	12	2030	123
Master	3DS Approved	*ALL	5204740000001002	12	2030	123
Master	3DS Approved	*ALL	5200000000002151	12	2030	123

Rejection test scenarios

Brand	Flow	Country	Card number	Expiry month	Expiry year	CVV
Master	Rejected	MX, CL, AR	5155901222280001	12	2030	123

Amount	Decline
8888.01	Card Expired
8888.02	Insufficient Funds
8888.03	Exceeds Withdrawal Limit
8888.05	Invalid Card Number