Getnet setembro | DEUNA Docs

Nesta página

Integrar Getnet SEP
Considerações e limitações especiais
Recursos de teste

Esta página fornece um guia para integrar Getnet SEP com DEUNA.

Operações Suportadas

A integração do Getnet SEP na sua estratégia de pagamento com DEUNA permite realizar as seguintes operações:

Autorização
Captura completa
Capturas parciais
Compra (capturada automaticamente)
Reembolso parcial (até um por pedido)
Reembolso total
Vazio
Parcela
3DS DEUNA

Métodos de pagamento suportados

Cartões

Visto
Mastercard
Jantares

Países e moedas ativos

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

Requisitos

Entre em contato com seu representante Getnet SEP e solicite as seguintes credenciais Getnet SEP:

Client ID
Segredo do cliente

Integrar Getnet SEP#

Integrar o Getnet SEP no DEUNA.

1. Procure Getnet SEP em Conexões

Pesquise Getnet SEP no DEUNA Admin.

Faça login na sua sessão de administração DEUNA.
Clique Conexões.
No resultado Getnet, clique em Conectar.

Exemplo interativoUsa dados de exemplo e não faz solicitações à API.

Pagamentos

Conexões

Descubra e gerencie integrações de pagamento, carteiras e antifraude.

Acme LATAM · Produção

Pesquisar conexões

Conexões	Tipo	Status
Adyen	Gateway de pagamento	Conectada
Worldpay	Gateway de pagamento	Conectada
PayPal	Forma de pagamento	Conectada
Mercado Pago	Forma de pagamento	Não conectada
Riskified	Mecanismo antifraude	Não conectada

2. Configure o Getnet SEP em sua loja

No Connections, uma janela como a seguinte será aberta:

Insira as seguintes credenciais:
- Em Nome insira um nome para fazer referência à credencial.
- Em Moeda selecione a moeda do processador do comerciante disponível.
- Em Client ID insira o Client ID do Getnet SEP.
- Em Segredo do cliente insira o segredo do cliente do Getnet SEP.
- Em Canal entrar DN (sempre para SBX ou PROD)
Escolha o tipo de operação que deseja realizar:
- Comprar
- Autorização
Escolha se deseja ativar o 3DS.
Clique Conectar.

Depois de concluir as etapas, você verá uma mensagem de sucesso.

3. Processe pagamentos com Getnet SEP

Você verá a conexão Getnet SEP na guia Conexões ativas.

A partir deste momento, você já pode processar transações com Getnet SEP através da DEUNA.

Exemplo de compra 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"
                    }
                }
            ]
        }
    }
}

Exemplo de solicitação com opções de parcelamento

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

Considerações e limitações especiais#

Endereço de cobrança

As transações nacionais adquiridas pela Getnet SEP em AR, MX, CL e BR deverão incluir as seguintes informações do shopper na solicitação de autorização:

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Isto segue a regulamentação local para retenção de impostos na província do comprador. Quando esses dados não são fornecidos, a Getnet SEP retém o imposto com base na localização do estabelecimento comercial.

Lista de códigos ISO por país:

Código de província ISO de MX	Nome da província de MX
MX-AGU	Aguascalientes
MX-BCN	Baixa Califórnia
MX-BCS	Baixa Califórnia Sul
MX-CAM	Campeche
MX-CHP	Chiapas
MX-CHH	chihuahua
MX-CMX	Cidade do México
MX-COA	Coahuila
MX-COL	Colima
MX-DUR	Durango
MX-MEX	Estado do 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	Novo Leão
MX-OAX	Oaxaca
MX-PUE	Puebla
MX-QUE	Querétaro
MX-ROO	Quintana Roo
MX-SLP	São Luís 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

Código de província ISO de AR	Nome da Província de AR
AR-C	CABA
AR-P	Formosa
AR-D	São Luís
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	Córdoba
AR-F	La Rioja
AR-G	Santiago del Estero
AR-J	São João
AR-M	Mendoza
AR-N	Missões
AR-Q	Neuquén
AR-R	Rio Negro
AR-V	Terra do Fogo
AR-B	Buenos Aires
AR-S	Santa Fé
AR-T	Tucumán
AR-W	Corrientes

Código de província ISO de CL	Nome da Província de CL
CL-RM	Região Metropolitana de Santiago
CL-AN	Antofagasta
CL-AP	Arica e Parinacota
CL-AT	Atacama
CL-AI	Aisén
CL-BI	Biobio
CL-CO	Coquimbo
CL-AR	La Araucanía
CL-LL	Lagos
CL-LR	Los Rios
CL-MA	Magalhães
CL-ML	Maulé
CL-NB	Ñúble
CL-LI	O'Higgins
CL-TA	Tarapacá
CL-VS	Valparaíso

Código da província ISO do BR	Nome da Província de 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	Pernambucano
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

Código da moeda: especifica o código da moeda (ISO 4217) do país relevante.
Código do país: especifica o Códigos de país ISO
O número de parcelas é validado em relação ao número máximo de parcelas acordado com o adquirente.
Um pagamento que é AUTHORIZED pode ser capturado.
Uma captura parcial pode ser realizada, se necessário.
Cada pagamento autorizado permite uma captura parcial ou total.
Recomenda-se capturar um pedido no prazo de 5 dias após a autorização para evitar a expiração.
Um reembolso só pode ser solicitado após o pagamento chegar ao CAPTURED status.
Os reembolsos não podem exceder o valor original capturado, mas podem ser realizados um ou mais reembolsos parciais do valor capturado.
Vários reembolsos parciais podem ser enviados por pedido.
Reembolsos parciais, ou seja, um valor inferior ao valor total da transação.
Um pagamento só pode ser cancelado (Anulado) depois de atingir o AUTHORIZED status.
O cancelamento não é mais possível quando o pagamento chega ao CAPTURED status.
O cancelamento total (anulado) pode ser enviado por pedido.
As parcelas podem ser customizadas para oferecer um número específico de pagamentos e podem incluir opções sem juros ou cobranças definidas pelo lojista. Como funciona:
1. O cliente escolhe o parcelamento - Através da API Get Parcelamento o cliente poderá obter as opções de parcelamento disponíveis. A resposta incluirá o número da parcela junto com o valor da parcela, excluindo juros. Este serviço não retornará taxas de juros, pois é um acordo direto com o adquirente ou emissor.
2. Processamento de pagamentos através da DEUNA - Processamos o pagamento com as respetivas prestações diretamente com a PSP.
Antes de aceitar pagamentos na América Latina, é necessária uma entidade legal e um adquirente no país de operação.
O acquirer_transaction_id campo é retornado na resposta de pagamento e contém o identificador da transação atribuído pelo adquirente. A DEUNA captura esse valor do GetNet SEP e o expõe de forma consistente em todas as superfícies de transação, incluindo respostas de API, webhooks e detalhes de transação. Use esse identificador ao reconciliar transações, solucionar problemas de pagamento ou interagir diretamente com o adquirente em relação a uma transação específica.

Recursos de teste#

Coleção do Postman

Solicite a coleção atual do Getnet SEP Postman à sua equipe de integração DEUNA antes de testar as APIs.

Cartões de teste

Marca	Fluxo	País	Número do cartão	Mês de vencimento	Ano de validade	CVV
Mestre	Aprovado	MX	5155901222260000	12	2030	123
Visto	Aprovado	CL	4042050000001005	12	2030	123
Mestre	Aprovado	BR	5155901222280001	12	2030	123
Visto	Aprovado	AR	4042050000001005	12	2030	123
Mestre	3DS aprovado	*ALL	5204740000001002	12	2030	123
Mestre	3DS aprovado	*ALL	5200000000002151	12	2030	123

Cenários de teste de rejeição

Marca	Fluxo	País	Número do cartão	Mês de vencimento	Ano de validade	CVV
Mestre	Rejeitado	MX, CL, AR	5155901222280001	12	2030	123

Quantidade	Recusar
8888.01	Cartão expirado
8888.02	Fundos insuficientes
8888.03	Excede o limite de retirada
8888.05	Número de cartão inválido