Desarrolladores

Webhooks

10min

Qué es un Webbook

Un webhook es un mecanismo mediante el cual Unicobros será capaz de notificar mediante HTTP POST a su servidor cuando una transacción sea realizada o cambie de estado, así usted podrá tomar las acciones necesarias en su sistema al efecto de reflejar el nuevo estado de una operación.

Servicios que soportan Webhooks

  • Checkout
  • Ordenes de Pago
  • Suscripciones

Datos especiales

  • Checkout: Checkout agregará al final del Objeto "data" un nodo con tu información personalizada, tal como el ID de Checkout
  • Subscription: El módulo de Suscripciones agregará información sobre la suscripción, suscriptor y ejecución al final del Objeto "data".
  • Órdenes de Pago: El módulo Ordenes de Pago no agrega datos adicionales.



Consideraciones Especiales

Para poder utilizar el servicio de Webhooks, la plataforma destino debera soportar cifrado TLS 1.2 en adelante, no debiendo soportar las versiones 1.1 y anteriores.

Ejemplo de Contenido enviado en un WebHook Simple



Headers

Content-Type: application/json

Ejemplo de Contenido enviado en un WebHook Simple Pago con Código de Barra

JSON


Ejemplo de Contenido enviado en un WebHook de Checkout

JSON


Ejemplo de Contenido enviado en un Webhook de Checkout con items tipo suscripción

JSON


Ejemplo de Contenido enviado en un WebHook de Suscripciones

JSON


Webhooks Especiales

Tipo de Operatoria

  • Split
  • Split Distribuído
  • Split Híbrido
  • Multicard
  • Multi-Vendor

En estos casos adicionalmente a la información standard enviada en un Webhook se enviarán las Transacciones Hijas de la operación principal bajo el campo "childs"



JSON