Configuración Inicial vía Merchant Portal
Este documento aplica a los siguientes países:
| Argentina | Chile | México |
|---|
Para otros países, consulte el documento Configuración Inicial vía API.
Para procesar transacciones con Web Checkout, se deben completar cuatro configuraciones en el módulo Web Checkout del Merchant Portal de Getnet.
Paso 1: Opciones de pago y cuotas
Los comercios pueden configurar opcionalmente su experiencia de checkout habilitando o deshabilitando operaciones de pago específicas. Estas configuraciones determinan qué métodos de pago, como Tarjetas de Crédito y Tarjetas de Débito, se muestran durante el proceso de checkout.
Esta flexibilidad permite a los comercios ofrecer las opciones de pago que mejor se adapten a las necesidades de su negocio y de sus clientes.
<doc-tabs active="1">
<doc-tab label="Argentina"></doc-tab>
<doc-tab label="Chile"></doc-tab>
<doc-tab label="Mexico"></doc-tab>
</doc-tabs>Los comercios también pueden configurar las opciones de cuotas disponibles para sus clientes, lo que les permite definir aspectos clave de la experiencia de cuotas. Estas configuraciones incluyen los planes de cuotas que se ofrecerán, el número de cuotas disponibles y la parte responsable de asumir los intereses, que puede ser asumida por el titular de la tarjeta o por el comercio.
Cuotas en Argentina
Existen dos tipos principales de opciones de cuotas ofrecidas a nivel país, que solo pueden procesarse con tarjetas nacionales o domésticas:
- Planes del emisor: Planes de cuotas base ofrecidos por el Emisor/Bancos.
- Planes gubernamentales (Cuota Simple / Plan Ahora): Opción ofrecida por el gobierno argentino, generalmente con tasas de interés más bajas que el plan del emisor.
Cuotas en Chile
Existen dos tipos principales de opciones de cuotas ofrecidas a nivel país:
- Planes del emisor: Planes de cuotas base ofrecidos por el Emisor/Bancos, con opciones que van de 2 a 48 cuotas. El comercio liquidará la transacción una sola vez y el titular de la tarjeta pagará el importe total y las comisiones correspondientes aplicadas posteriormente.
- Cuotas del comercio (Cuota Comercio): Plan sin comisiones ofrecido por el comercio, con opciones que van de 2 a 12 cuotas. El comercio liquidará la transacción varias veces, según el plan seleccionado.
Cuotas en México
Existe un tipo principal de opción de cuotas ofrecido a nivel país:
- MSI (Meses sin interés): Planes de cuotas base ofrecidos por PROSA, en los que el banco personal del cliente es responsable de cobrar los pagos, mientras que el comercio recibirá una liquidación única que incluye las comisiones deducidas.
Paso 2: Personalizar el checkout
Como funcionalidad opcional, los comercios pueden personalizar la apariencia de la interfaz de Web Checkout que se muestra a los clientes. Esto permite que la experiencia de checkout esté alineada con la identidad de marca del sitio de comercio electrónico. Las opciones de personalización disponibles incluyen color de marca, color de acento y tipografía.
<doc-tabs active="1">
<doc-tab label="Argentina"></doc-tab>
<doc-tab label="Chile"></doc-tab>
<doc-tab label="Mexico"></doc-tab>
</doc-tabs>Paso 3: URLs de redirección
Las URLs de redirección se utilizan para enviar a los clientes a endpoints predefinidos cuando una transacción es aprobada o rechazada durante el proceso de checkout.
Se deben proporcionar dos URLs:
- Success: para transacciones aprobadas.
- Error: para transacciones rechazadas.
Ambas URLs son obligatorias para completar correctamente la integración.
<doc-tabs active="1">
<doc-tab label="Argentina"></doc-tab>
<doc-tab label="Chile"></doc-tab>
<doc-tab label="Mexico"></doc-tab>
</doc-tabs>Paso 4: Notificaciones Webhook
Un webhook es un mecanismo ligero de comunicación orientado a eventos que permite que una aplicación notifique automáticamente a otra mediante HTTP. Este enfoque elimina la necesidad de polling continuo y permite el intercambio de datos casi en tiempo real, además de la integración entre sistemas.
Para implementar un webhook, el cliente proporciona una URL de callback única a la API del servidor y especifica los eventos que desea recibir. Debe proporcionar una URL de callback completamente cualificada (endpoint del servidor) en el paso final del proceso de configuración del checkout dentro del Merchant Portal.
Además, se requiere un usuario y una contraseña. Estas credenciales se incluirán como un valor codificado en base64 en el encabezado Authorization de cada notificación enviada por Getnet, y su servidor debe usarlas para validar que la notificación proviene de Getnet.
Una vez configurado el webhook, Getnet enviará automáticamente notificaciones a la URL especificada cada vez que ocurra un evento de transacción. Cada notificación incluye los datos originales del pago, junto con un objeto result, anidado dentro del objeto payment de nivel superior, que contiene el estado del pago y los detalles de autorización.
<doc-tabs active="1">
<doc-tab label="Argentina"></doc-tab>
<doc-tab label="Chile"></doc-tab>
<doc-tab label="Mexico"></doc-tab>
</doc-tabs>Aunque no es necesario enviar una confirmación formal, su sistema debe devolver una respuesta HTTP 200 exitosa. Si se devuelve una respuesta HTTP 500 de error, o si no se recibe ninguna respuesta, la notificación webhook se reenviará hasta 5 veces en intervalos crecientes.
Tras estos 5 intentos iniciales, la notificación se reenviará cada hora durante un máximo de 72 horas. Después de ese plazo, Getnet dejará de intentar nuevas notificaciones.
Aunque no se requiere una confirmación formal, su sistema debe devolver una respuesta HTTP 200 (OK) al recibir una notificación webhook. Si se devuelve una respuesta HTTP 500 (ERROR), o si no se recibe ninguna respuesta, la notificación se reintentará.
Getnet reenviará la notificación webhook hasta cinco veces en intervalos progresivamente crecientes. Si la notificación sigue sin entregarse correctamente tras estos intentos iniciales, los reintentos continuarán una vez por hora durante un máximo de 72 horas. Transcurrido este período, Getnet dejará de realizar nuevos intentos de notificación.
Ejemplo de payload de una transacción AUTHORIZED:
{
"payment_intent_id": "1f9f47ed-65cc-4fbf-a407-0f17df9a2e2c",
"checkout_id": "5ab15d1e-ea8b-4560-84d2-fb3d02179537",
"order_id": "YOUR_ORDER_ID",
"mode": "instant",
"seller": {
"id": "716d899e-9091-4577-a12f-8a77ec4d1e0b",
"trade_name": "GetNet Shop",
"merchant_document": "00000000000",
"settings": {
"notification_url_configured": true
}
},
"customer": {
"customer_id": "c129d793-d204-4610-8819-b8fb720a8552",
"first_name": "John",
"last_name": "Doe",
"name": "John Doe",
"email": "[email protected]",
"document_type": "dni",
"document_number": "1111111111111",
"checked_email": false,
"billing_address": {
"street": "South Rockledge St",
"number": "00",
"complement": "Rockville",
"country": "AR",
"postal_code": "00000000"
}
},
"shipping": {
"first_name": "John",
"last_name": "Doe",
"name": "John Doe",
"address": {
"street": "South Rockledge St",
"number": "00",
"complement": "Rockville",
"country": "AR",
"postal_code": "00000000"
}
},
"payment": {
"method": "credit",
"amount": 14100,
"currency": "ARS",
"installment": {
"quote_id": "f054ce63-0475-406f-8eca-25aea5dae6a8",
"schema": "plan_name",
"type": "with_interest",
"number": 6
},
"payment_method": {
"token_id": "e327bae6-286e-4920-addb-5f4b10315b4e"
},
"result": {
"payment_id": "3a76acae-d9c0-421c-91e0-cf5ce8aca098",
"status": "Authorized",
"authorization_code": "999999",
"transaction_datetime": "2024-01-01T12:00:00.000Z"
}
},
"pickup_store": false,
"product": [
{
"product_type": "cash_carry",
"title": "Look Fashion Leather Boot",
"value": 5300,
"quantity": 1
},
{
"product_type": "cash_carry",
"title": "Look Fashion Blazer",
"value": 8800,
"quantity": 1
}
],
"frontend": {
"link": "https://www.globalgetnet.com/",
"time_page": 39,
"sales_channel": "WEB",
"application_version": "0.0.0",
"card_pasted": true,
"ip": "000.000.00.00",
"timezone": "America/Sao_Paulo",
"locale": "en-US"
},
"created_at": "2024-01-01T12:00:00.000Z",
"updated_at": "2024-01-01T12:00:00.000Z"
}Ejemplo de payload de una transacción DENIED:
{
"payment_intent_id": "1f9f47ed-65cc-4fbf-a407-0f17df9a2e2c",
"checkout_id": "5ab15d1e-ea8b-4560-84d2-fb3d02179537",
"order_id": "YOUR_ORDER_ID",
"mode": "instant",
"seller": {
"id": "716d899e-9091-4577-a12f-8a77ec4d1e0b",
"trade_name": "Getnet Shop",
"merchant_document": "00000000000",
"settings": {
"notification_url_configured": true
}
},
"customer": {
"customer_id": "c129d793-d204-4610-8819-b8fb720a8552",
"first_name": "John",
"last_name": "Doe",
"name": "John Doe",
"email": "[email protected]",
"document_type": "dni",
"document_number": "1111111111111",
"checked_email": false,
"billing_address": {
"street": "South Rockledge St",
"number": "00",
"complement": "Rockville",
"country": "AR",
"postal_code": "00000000"
}
},
"shipping": {
"first_name": "John",
"last_name": "Doe",
"name": "John Doe",
"address": {
"street": "South Rockledge St",
"number": "00",
"complement": "Rockville",
"country": "AR",
"postal_code": "00000000"
}
},
"payment": {
"method": "credit",
"amount": 14100,
"currency": "ARS",
"installment": {
"quote_id": "f054ce63-0475-406f-8eca-25aea5dae6a8",
"schema": "plan_name",
"type": "with_interest",
"number": 6
},
"payment_method": {
"token_id": "e327bae6-286e-4920-addb-5f4b10315b4e"
},
"result": {
"payment_id": "3a76acae-d9c0-421c-91e0-cf5ce8aca098",
"status": "Denied",
"return_message": "Card not accepted for this operation",
"transaction_datetime": "2024-01-01T12:00:00.000Z"
}
},
"pickup_store": false,
"product": [
{
"product_type": "cash_carry",
"title": "Look Fashion Leather Boot",
"value": 5300,
"quantity": 1
},
{
"product_type": "cash_carry",
"title": "Look Fashion Blazer",
"value": 8800,
"quantity": 1
}
],
"frontend": {
"link": "https://www.globalgetnet.com/",
"time_page": 39,
"sales_channel": "WEB",
"application_version": "0.0.0",
"card_pasted": true,
"ip": "000.000.00.00",
"timezone": "America/Sao_Paulo",
"locale": "en-US"
},
"created_at": "2024-01-01T12:00:00.000Z",
"updated_at": "2024-01-01T12:00:00.000Z"
}Para más detalles, consulte la API reference