Saltar al contenido principal
Todos los sistemas operativosNovedadesv1
Iniciar sesión

Getnet SEP

En esta página

Esta página proporciona una guía para integrar Getnet SEP con DEUNA.

Operaciones soportadas

La integración de Getnet SEP en tu estrategia de pagos con DEUNA te permite realizar las siguientes operaciones:

  • Autorización
  • captura completa
  • Capturas parciales
  • Compra (captura automática)
  • Reembolso parcial (hasta uno por pedido)
  • Reembolso completo
  • Anulación
  • Cuota
  • 3DS DEUNA

Métodos de pago admitidos

Tarjetas

  • visa
  • Mastercard
  • Comensales

Países y monedas activos

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

Requisitos

Comuníquese con su representante de Getnet SEP y solicite las siguientes credenciales de Getnet SEP:

  • Client ID
  • Secreto del cliente

Integrar Getnet SEP#

Integrar Getnet SEP en DEUNA.

1. Busque Getnet SEP en Conexiones

Busque Getnet SEP en el Administrador de DEUNA.

  1. Inicie sesión en su sesión de administrador de DEUNA.
  2. Clic Conexiones.
  3. En el resultado de Getnet, haga clic en Conectar.
Ejemplo interactivoUsa datos de ejemplo y no realiza solicitudes de API.
Producción
Pagos

Conexiones

Descubre y administra integraciones de pago, billeteras y antifraude.

Acme LATAM · Producción
5 conexiones de ejemploActualizado ahora
ConexionesTipoEstadoAcción
AdyenPasarela de pagoConectada
WorldpayPasarela de pagoConectada
PayPalMétodo de pagoConectada
Mercado PagoMétodo de pagoSin conectar
RiskifiedMotor antifraudeSin conectar

2. Configura Getnet SEP en tu tienda

En Conexiones se abrirá una ventana como la siguiente:

  1. Ingrese las siguientes credenciales:
    • En Nombre introduzca un nombre para hacer referencia a la credencial.
    • En Moneda seleccione la moneda del procesador comercial disponible.
    • En Client ID ingrese la ID de cliente de Getnet SEP.
    • En Secreto del cliente ingrese el secreto del cliente de Getnet SEP.
    • En Canal entrar DN (siempre a SBX o PROD)
  2. Elija el tipo de operación que desea realizar:
    • Compra
    • Autorización
  3. Elige si quieres activar 3DS.
  4. Clic Conectar.

Una vez que complete los pasos, verá un mensaje de éxito.

3. Procesar pagos con Getnet SEP

Verá la conexión Getnet SEP dentro de la pestaña Conexiones activas.

A partir de este momento ya podrás procesar transacciones con Getnet SEP a través de DEUNA.

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

Ejemplo de solicitud con opciones de plan de pago a plazos

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

Consideraciones y limitaciones especiales#

dirección de facturación

Las transacciones nacionales adquiridas por Getnet SEP en AR, MX, CL y BR deben incluir la siguiente información del comprador en la solicitud de autorización:

  • billing_address.zipcode
  • billing_address.state_name
  • billing_address.country_code

Esto sigue la regulación local para retener impuestos en la provincia del comprador. Cuando no se proporcionan estos datos, Getnet SEP retiene impuestos según la ubicación del comerciante.

Lista de códigos ISO por país:

Código de provincia ISO de MXProvincia Nombre de MX
MX-AGUAguascalientes
MX-BCNBaja California
MX-BCSBaja California Sur
MX-CAMCampeche
MX-CHPChiapas
MX-CHHchihuahua
MX-CMXCiudad de México
MX-COACoahuila
MX-COLColima
MX-DURdurango
MX-MEXestado de mexico
MX-GUAGuanajuato
MX-GROGuerrero
MX-HIDHidalgo
MX-JALJalisco
MX-MICMichoacán
MX-MORMorelos
MX-NAYNayarit
MX-NLENuevo León
MX-OAXOaxaca
MX-PUEpuebla
MX-QUEQuerétaro
MX-ROOQuintanaRoo
MX-SLPSan Luis Potosí
MX-SINSinaloa
MX-SONSonora
MX-TABtabasco
MX-TAMTamaulipas
MX-TLATlaxcala
MX-VERVeracruz
MX-YUCYucatán
MX-ZACZacatecas
Código de provincia ISO de ARProvincia Nombre de AR
AR-CCABA
AR-PFormosa
AR-Dsanluis
AR-EEntre Ríos
AR-LLa Pampa
AR-ASalta
AR-HChaco
AR-UChubut
AR-YJujuy
AR-Zsanta cruz
AR-KCatamarca
AR-XCórdoba
AR-FRioja
AR-Gsantiago del estero
AR-Jsan juan
AR-MMendoza
AR-NMisiones
AR-QNeuquén
AR-RRío Negro
AR-VTierra del Fuego
AR-Bbuenos aires
AR-SSanta Fé
AR-TTucumán
AR-WCorrientes
Código de provincia ISO de CLProvincia Nombre de CL
CL-RMRegión Metropolitana de Santiago
CL-ANantofagasta
CL-APArica y Parinacota
CL-ATatacama
CL-AIAysén
CL-BIBiobío
CL-COCoquimbo
CL-ARLa Araucanía
CL-LLLos Lagos
CL-LRLos Rios
CL-MAmagallanes
CL-MLMaule
CL-NBÑuble
CL-LIO'Higgins
CL-TATarapacá
CL-VSValparaíso
Código de provincia ISO de BRProvincia Nombre de BR
BR-SPSão Paulo
BR-RJRío de Janeiro
BR-ACacre
BR-ALAlagoas
BR-APAmapa
BR-AMamazonas
BR-BABahía
BR-CECeará
BR-DFDistrito Federal
BR-ESEspíritu Santo
BR-GOGoias
BR-MAmaranhao
BR-MTMato Grosso
BR-MSMato Grosso del Sur
BR-MGMinas Gerais
BR-PAPará
BR-PBParaíba
BR-PRParaná
BR-PEPernambuco
BR-PIPiauí
BR-RNRío Grande del Norte
BR-RSRío Grande del Sur
BR-RORondonia
BR-RRRoraima
BR-SCsanta catarina
BR-SESergipe
BR-TOTocantinsCABA
  1. Código de moneda: especifica el código de moneda (ISO 4217) para el país correspondiente.
  2. Código de país: especifica el Códigos ISO de países
  3. El número de cuotas se valida contra el número máximo de cuotas acordado con el adquirente.
  4. Un pago que es AUTHORIZED puede ser capturado.
  5. Se puede realizar una captura parcial si es necesario.
  6. Cada pago autorizado permite una captura parcial o total.
  7. Se recomienda capturar un pedido dentro de los 5 días posteriores a la autorización para evitar su vencimiento.
  8. Se puede solicitar un reembolso sólo después de que el pago llegue al CAPTURED status.
  9. Los reembolsos no pueden exceder el monto capturado original, pero se pueden realizar uno o más reembolsos parciales del monto capturado.
  10. Se pueden enviar múltiples reembolsos parciales por pedido.
  11. Reembolsos parciales, es decir, un monto inferior al valor total de la transacción.
  12. Un pago puede cancelarse (anularse) sólo después de que alcance el AUTHORIZED status.
  13. La cancelación ya no es posible una vez que el pago llega al CAPTURED status.
  14. Se puede enviar una cancelación completa (anulación) por pedido.
  15. Las cuotas se pueden personalizar para ofrecer una cantidad específica de pagos y pueden incluir opciones sin intereses o cargos definidos por el comerciante. Cómo funciona:
    1. El cliente elige las cuotas: a través de la API Get Installment, el cliente podrá obtener las opciones de pago a plazos disponibles. La respuesta incluirá el número de la cuota junto con el monto de la cuota sin incluir los intereses. Este servicio no devolverá tasas de interés, ya que es un acuerdo directo con el adquirente o emisor.
    2. Procesamiento de pagos a través de DEUNA - Procesamos el pago con las respectivas cuotas directamente con el PSP.
  16. Antes de realizar pagos en América Latina se requiere una persona jurídica y un adquirente en el país de operación.
  17. El acquirer_transaction_id El campo se devuelve en la respuesta de pago y contiene el identificador de transacción asignado por el adquirente. DEUNA captura este valor de GetNet SEP y lo expone de manera consistente en todas las superficies de transacciones, incluidas las respuestas de API, webhooks y detalles de transacciones. Utilice este identificador al conciliar transacciones, solucionar problemas de pago o interactuar directamente con el adquirente con respecto a una transacción específica.

Recursos de prueba#

Colección de Postman

Solicite la colección actual de Getnet SEP Postman a su equipo de integración de DEUNA antes de probar las API.

Tarjetas de prueba

MarcaFlujoPaísNúmero de tarjetaMes de vencimientoAño de caducidadCVV
maestroAprobadoMX5155901222260000122030123
visaAprobadoCL4042050000001005122030123
maestroAprobadoBR5155901222280001122030123
visaAprobadoAR4042050000001005122030123
maestroAprobado por 3DS*ALL5204740000001002122030123
maestroAprobado por 3DS*ALL5200000000002151122030123

Escenarios de prueba de rechazo

MarcaFlujoPaísNúmero de tarjetaMes de vencimientoAño de caducidadCVV
maestroRechazadoMX, CL, AR5155901222280001122030123
MontoRechazar
8888.01Tarjeta caducada
8888.02Fondos insuficientes
8888.03Excede el límite de retiro
8888.05Número de tarjeta no válido