Callbacks de notificación
Además de los webhooks, Getnet proporciona notificaciones basadas en callback: el servidor llama a las URL que usted proporciona (callbacks) para notificar a su sistema sobre eventos de pago. Este mecanismo utiliza peticiones HTTP GET con datos en la query string y se configura en el momento de la acreditación. Es distinto de los webhooks que se ofrecen en la Global API, los cuales utilizan HTTP POST, suscripciones configurables y un formato de payload diferente.
Para configurar las notificaciones de Getnet vía callback, debe indicar 4 URL en el momento de su acreditación en la Plataforma Digital. Cada una estará destinada a recibir diferentes notificaciones de los siguientes tipos:
- Transacciones de crédito,
- Transacciones de débito,
- Transacciones de recibo bancario (boleto),
- Transacciones recurrentes (suscripción)
Una vez configuradas las URL de callback, Getnet enviará automáticamente los datos relevantes a cada URL cuando ocurra el evento especificado. En caso de error, la información se reenviará cada 15 minutos hasta 4 veces.
Siempre recomendamos estar atentos a la fecha de caducidad del certificado para cada URL. En caso de renovación o si necesita modificar alguna de las URL indicadas originalmente, por favor, póngase en contacto con nuestro Equipo de Soporte de Integración de Getnet.
Estructura de las notificaciones
En términos generales, las peticiones HTTP tienen la siguiente estructura:
https://YOUR_HOST_EXAMPLE/YOUR_SERVICE_EXAMPLE?query_param_1=valueExample1&query_param_2=valueExample2
Donde:
https://YOUR_HOST/YOUR_SERVICEse refiere a una de las 4 URL de callback indicadas anteriormente.?indica el inicio de la sección de la query.query_param_1=valueExample1es un ejemplo de un query parameter.&se utiliza como conector entre múltiples query parameters.
Las notificaciones HTTP GET proporcionadas por Getnet incluirán un conjunto específico de query parameters, algunos de los cuales se comparten entre diferentes eventos de activación, mientras que otros son únicos y específicos para un solo evento de activación.
Notificaciones de crédito
Query param compartido para todos los eventos A continuación encontrará la lista de los query params compartidos en todos los eventos relacionados con transacciones de tarjeta de crédito: Approved, Authorized, Pending, Confirmed, Canceled, Denied y Error.
| Query parameters | Descripción |
|---|---|
| payment_type | (único valor posible:) credit |
| customer_id | (código de Id del cliente) |
| order_id | (número de pedido) |
| payment_id | (Id de transacción en formato UUIDv4) |
| amount | (importe de la transacción) |
| status | (valores posibles dependiendo del tipo de evento de la transacción:) APPROVED AUTHORIZED PENDING CONFIRMED CANCELED DENIED ERROR |
| number_installments | (número de plazos) |
| terminal_nsu | (código de autorización generado por el emisor cuando una transacción se realiza con éxito) |
| authorization_code | (código de autorización generado por el sistema de ecommerce de Getnet) |
A continuación encontrará los query parameters adicionales para cada evento específico.
Parámetros adicionales para eventos de transacción Approved, Authorized y Pending
| Query parameters | Descripción |
|---|---|
| acquirer_transaction_id | (código de transacción del comprador) |
| authorization_timestamp | (fecha y hora de la autorización) |
| brand | (marca de la tarjeta) |
Parámetros adicionales para eventos de transacción Canceled
| Query parameters | Descripción |
|---|---|
| acquirer_transaction_id | (código de transacción del comprador) |
Parámetros adicionales para eventos de transacción Denied y Error
| Query parameters | Descripción |
|---|---|
| acquirer_transaction_id | (código de transacción del comprador) |
| description_detail | (descripción del error ocurrido durante la transacción) |
| error_code | (código numérico de denegación o error) |
Notificaciones de débito
Query param compartido para todos los eventos
A continuación encontrará la lista de los query params compartidos en todos los eventos relacionados con transacciones de tarjeta de débito: Approved, Denied y Error.
| Query parameters | Descripción |
|---|---|
| payment_type | (único valor posible:) debit |
| customer_id | (código de Id del cliente) |
| order_id | (número de pedido) |
| payment_id | (Id de transacción en formato UUIDv4) |
| amount | (importe de la transacción) |
| status | (valores posibles dependiendo del tipo de evento de la transacción:) APPROVED DENIED ERROR |
| brand | (marca de la tarjeta) |
A continuación encontrará los query parameters adicionales para cada evento específico.
Parámetros adicionales para eventos de transacción Approved
| Query parameters | Descripción |
|---|---|
| acquirer_transaction_id | (código de transacción del comprador) |
| authorization_timestamp | (fecha y hora de la autorización) |
| terminal_nsu | (código de autorización generado por el emisor cuando una transacción se realiza con éxito) |
| authorization_code | (código de autorización generado por el sistema de ecommerce de Getnet) |
Parámetros adicionales para eventos de transacción Denied y Error
| Query parameters | Descripción |
|---|---|
| description_detail | (descripción del error ocurrido durante la transacción) |
| error_code | (código numérico de denegación o error) |
Notificaciones de recibo bancario (Boleto)
En el caso de una notificación de recibo bancario, se enviará en dos etapas. En la primera etapa, se envía una notificación cuando finaliza el registro del recibo bancario, y en la segunda etapa, se envía una notificación cuando el recibo se liquida. El servicio sigue siendo el mismo; sin embargo, los campos de respuesta diferirán entre las dos etapas.
Primera Etapa
Query param compartido para todos los eventos A continuación encontrará la lista de los query params compartidos en todos los eventos relacionados con acciones de la primera etapa: Pending, Denied y Error.
| Query parameters | Descripción |
|---|---|
| payment_type | (único valor posible:) boleto |
| order_id | (número de pedido) |
| payment_id | (identificador del pago) |
| amount | (importe del recibo bancario) |
| status | (valores posibles dependiendo del tipo de evento de la transacción:) PENDING DENIED ERROR |
| bank | (código bancario del emisor del recibo bancario. El único valor posible es Banco Santander) |
| our_number | (nuestro número. Si no lo indica, será generado por el banco emisor) |
| typefull_line | (línea digitable del recibo bancario devuelta por el banco emisor) |
| issue_date | (Fecha de emisión, formato: DDMMYYYY) |
| expiration_date | (Fecha de caducidad, formato: DDMMYYYY) |
A continuación encontrará los query parameters adicionales para cada evento específico.
Parámetros adicionales para eventos de transacción Denied y Error
| Query parameters | Descripción |
|---|---|
| id | (identificador del recibo bancario, formato: UUIDv4. Se utiliza para identificar el recibo bancario para la notificación de liquidación) |
| description_detail | (descripción del error ocurrido durante la transacción) |
| error_code | (código numérico de denegación o error) |
Segunda Etapa
Query param compartido para todos los eventos A continuación encontrará la lista de los query params compartidos en todos los eventos relacionados con acciones de la segunda etapa: Paid y Canceled.
| Query parameters | Descripción |
|---|---|
| id | (identificador del recibo bancario, formato: UUIDv4. Se utiliza para identificar el recibo bancario para la notificación de liquidación) |
| amount | (importe del recibo bancario) |
| status | (valores posibles dependiendo del tipo de evento de la transacción:) PAID CANCELED |
| payment_date | (Fecha en que su cliente paga el recibo bancario, formato: DDMMYYYY) |
Notificaciones de transacciones recurrentes (suscripción)
Query param compartido para todos los eventos A continuación encontrará la lista de los query params compartidos en todos los eventos relacionados con transacciones recurrentes: Authorized, Approved, Confirmed, Canceled, Denied y Error.
| Query parameters | Descripción |
|---|---|
| payment_type | (único valor posible:) credit |
| customer_id | (código de Id del cliente) |
| order_id | (número de pedido) |
| payment_id | (Id de transacción en formato UUIDv4) |
| amount | (importe de la transacción) |
| status | (valores posibles dependiendo del tipo de evento de la transacción:) AUTHORIZED APPROVED CONFIRMED CANCELED DENIED ERROR |
| authorization_timestamp | (fecha y hora de la autorización) |
| acquirer_transaction_id | (código de transacción del comprador) |
| subscription_id | (identificador de suscripción, formato: UUIDv4) |
| plan_id | (identificador del plan utilizado en la suscripción, formato: UUIDv4) |
| charge_id | (identificador del cargo, formato: UUIDv4) |
| number_installments | (número de plazos) |
| billing_number | (número del plazo procesado) |
| brand | (marca de la tarjeta) |
| terminal_nsu | (código de autorización generado por el emisor cuando una transacción se realiza con éxito) |
| authorization_code | (código de autorización generado por el sistema de ecommerce de Getnet) |
| retry_number | (número de reintentos) |
A continuación encontrará los query parameters adicionales para cada evento específico.
Parámetros adicionales para eventos de transacción Denied y Error
| Query parameters | Descripción |
|---|---|
| description_detail | (descripción del error ocurrido durante la transacción) |
| error_code | (código numérico de denegación o error) |
Notificaciones de método de pago alternativo (PIX)
Query param compartido para todos los eventos
A continuación encontrará la lista de los query params compartidos en todos los eventos relacionados con transacciones PIX: Approved, Denied y Error.
| Query parameters | Descripción |
|---|---|
| payment_type | (único valor posible:) pix |
| customer_id | (código de Id del cliente) |
| order_id | (número de pedido) |
| payment_id | (Id de transacción en formato UUIDv4) |
| amount | (importe de la transacción) |
| status | (valores posibles dependiendo del tipo de evento de la transacción:) APPROVED DENIED ERROR |
| transaction_id | (identificador de la transacción en la institución PSP tras generar el código QR) |
| transaction_timestamp | (fecha y hora de la transacción PIX, formato: ISO) |
| terminal_nsu | (código de autorización generado por el emisor cuando una transacción se realiza con éxito) |
A continuación encontrará los query parameters adicionales para cada evento específico.
Parámetros adicionales para eventos de transacción Approved
| Query parameters | Descripción |
|---|---|
| payer_psp_name | Nombre de la institución PSP del pagador |
| payer_psp_code | Código de la institución PSP del pagador |
| payer_name | Nombre del pagador |
| payer_cnpj | Número de CNPJ del pagador para persona jurídica |
| payer_cpf | Número de CPF del pagador para particulares |
| receiver_psp_name | Nombre de la institución PSP del receptor |
| receiver_psp_code | Código de la institución PSP del receptor |
| receiver_name | Nombre del receptor |
| receiver_cnpj | Número de CNPJ del receptor para persona jurídica |
| receiver_cpf | Número de CPF del receptor para particulares |
Parámetros adicionales para eventos de transacción Denied y Error
| Query parameters | Descripción |
|---|---|
| description_detail | (descripción del error ocurrido durante la transacción) |