Webhooks

Recibe notificaciones en tiempo real cuando ocurran eventos en tu cuenta.

Configuración

Puedes configurar la URL del webhook al momento de crear un Link de Pago o una Suscripción. Pabilo enviará una petición POST a esa URL cuando el pago sea verificado exitosamente.

Payload del Evento

El cuerpo de la petición (JSON) contendrá la información del pago verificado.

POST Webhook Payload Example

{
  "payment_link_id": "675725869e6febc736848bf1",
  "status": "paid",
  "credit_balance": 150.50,
  "payment_link": {
    "id": "675725869e6febc736848bf1",
    "name": "Pago de Servicio",
    "amount": 50.00,
    "currency": "USD",
    "description": "Orden #1234",
    "webhook_url": "https://miapp.com/webhook/pabilo",
    "status": "paid",
    "url": "https://pabilo.app/pay/675725869e6febc736848bf1",
    "with_subscription_id": null,
    "type": "default"
  },
  "user_bank_payment": {
    "bank_reference_id": "0025513902095",
    "amount": 36067.28,
    "status": "paid"
  }
}

Nota: Asegúrate de que tu servidor devuelva un estado HTTP 200 OK rápidamente para confirmar la recepción.

Si el webhook no puede entregarse, el pago no se revierte: el intento queda registrado y recibirás un correo avisándote del fallo.

Suscripciones: el webhook_url configurado al crear la suscripción se propaga a cada link de pago generado (primer cobro y renovaciones), que llegará con type: "subscription" y with_subscription_id.

Validación de Seguridad

Recomendamos verificar que la petición provenga realmente de Pabilo. (Próximamente: Firma digital en headers).