Integración y API
      Volver al inicio
      1. Guías de soporte
      2. Integración y API

      Cómo configurar webhooks para actualizaciones de pagos en tiempo real

      Esta guía explica cómo crear webhooks dentro de su panel de control para recibir actualizaciones del estado de pago en tiempo real, como pagos insuficientes, pagos en exceso, pagos completados y reembolsos.

      1. Introducción

      Los webhooks permiten que su sistema reciba notificaciones automáticas cuando se producen pagos específicos. Esto permite actualizaciones en tiempo real del seguimiento de pedidos, los sistemas de notificación o los informes internos.

      2. Creación de un webhook

      Siga estos pasos para crear un webhook en su panel de control:

      1. Vaya a: Settings > Integrations > Webhooks o utilice este enlace directo (requiere iniciar sesión) .

      2. En la sección ' + Crear Webhooks'

      3. Introduzca una etiqueta de webhook (por ejemplo, "Actualizaciones del estado del pedido")

      4. Seleccione uno o más eventos que desee escuchar:

        • paymentUnderpaid

        • paymentOverpaid

        • paymentCompleted

        • refundCompleted

      5. Ingrese su punto final de recepción (la URL de su servidor que procesará el webhook entrante)

      6. Haga clic en Crear

      Después de la creación, su webhook aparecerá en la lista a continuación con su nombre , punto final de recepción , clave secreta y fecha de creación .

      3. Descripciones de eventos

      Evento Descripción
      paymentUnderpaid Se activa cuando se recibe un pago pero es inferior al monto esperado
      paymentOverpaid Se activa cuando un pago excede el monto esperado
      paymentCompleted Se activa cuando se confirma correctamente un pago.
      refundCompleted Se activa cuando se ha procesado y completado un reembolso.
       

      4. Protección y gestión de webhooks

      • Utilice la clave secreta indicada para cada webhook para validar las solicitudes entrantes en su servidor.

      • Verifique los encabezados de firma para garantizar que las solicitudes provengan de una fuente confiable.

      • Responda con un200 OK estado HTTP para confirmar la recepción.

      • Implemente la lógica de reintento en caso de que su punto final no esté disponible temporalmente.

      5. Solución de problemas

      • ¿No se activan webhooks?

        • Asegúrese de que su punto final sea accesible a través de HTTPS.

        • Asegúrese de que al menos un evento esté seleccionado.

      • ¿Recibiendo cargas útiles no válidas?

        • Comprueba si tu punto final analiza correctamente application/json.