Saltar al contenido principal

Evento de intento de pago fallido​

Descripción​

Se produce cada vez que un pagador falla un intento de pago en una sesión. Se envía una notificación por cada intento fallido: si el pagador falla 3 veces, se envían 3 webhooks, idénticos salvo por failure.attempt_number, failure.id y failure.failed_at.

Este webhook viene desactivado por defecto. Solo lo reciben los comercios que lo activen en el acuerdo mediante el campo webhook_events ("payment_session.payment_failed": true) al crear el acuerdo.

Endpoint​

Webhook

Request​

Ejemplos de Body (JSON)​

Ejemplo de request de intento de pago fallido​

{
  "event": "payment_session.payment_failed",
  "data": {
    "session_payment": {
      "id": "672f29cf-a31c-40a3-bf91-0272f8439c2d",
      "origin": "button",
      "agreement_id": "agr_561d815373d4f039",
      "currency_reference": "VES",
      "amount_reference": 5,
      "identifier_label": "Número de apartamento",
      "identifier": "241",
      "description": "Pago de mensualidad de condominio",
      "payment_method": "immediate_debit"
    },
    "failure": {
      "id": "e8ec0c78-276f-472b-a8c8-b27078d062ba",
      "attempt_number": 2,
      "message": "Clave de pago incorrecta",
      "bank_name": "Banco Sofitasa",
      "failed_at": "2026-10-01T10:32:08-04:00"
    }
  }
}

Responses​

Webhook procesado exitosamente