Catálogo de eventos de webhook de Therius y sus cargas

Esta página lista cada tipo de evento que Therius entrega a un endpoint de webhook configurado. Suscríbete a un subconjunto en Desarrolladores → Webhooks, o deja la selección vacía para recibirlos todos. Ver Descripción general de webhooks para los detalles de entrega, reintento y verificación de firma.

Eventos de pago

Las cargas de eventos de pago usan esta envoltura:

{
  "event": "payment.captured",
  "environment": "production",
  "created_at": "2026-08-29T12:00:00Z",
  "data": {
    "payment_id": "b1f2...",
    "transaction_id": "t_9a8b...",
    "order_code": "ORDER-001",
    "payment_code": "PAY-abc123",
    "merchant_id": 42,
    "status": "captured",
    "amount": 1999,
    "currency": "USD",
    "exponent": 2,
    "authorization_code": "OK123"
  }
}

Cuando el pago guardó una tarjeta (tokenize: true), data.token la trae como { "id": "vt_...", "expirationDate": "...", "tokenCreationReference": "..." }, el mismo objeto que la respuesta del purchase. Una tarjeta en un pago asíncrono (el proveedor respondió pending) se guarda cuando el pago se resuelve. Si eso ocurre después de enviar el webhook, data.token no viene y recibes un evento token.created.

Evento	Se dispara cuando
`payment.authorized`	Se reservaron fondos con una llamada de `authorization` (o el tramo de autorización de un `purchase`).
`payment.captured`	Una captura tuvo éxito — incluida la captura automática dentro de `purchase`, y la confirmación de un pago APM o de voucher asíncrono.
`payment.refused`	El emisor o el adquirente rechazó el pago. Corresponde a un estado `declined` en la respuesta síncrona de la API — ver Pagos rechazados para saber cómo leer el rechazo.
`payment.refunded`	Se procesó un reembolso. Se dispara en cada reembolso; `data.status` es `refunded` solo una vez que el pago está totalmente reembolsado.
`payment.canceled`	Se anuló una autorización antes de la captura.
`payment.chargeback`	Se planteó una disputa contra un pago liquidado (recibida de la notificación de disputa del adquirente).
`payment.capture_failed`	Falló un intento de captura. El pago permanece en `authorized`.
`payment.refund_failed`	Falló un intento de reembolso. El pago permanece en `captured`.
`payment.cancel_failed`	Falló un intento de cancelación. El pago permanece en `authorized`.

Los nombres de los eventos de webhook usan refused donde el campo status de la respuesta síncrona de la API usa declined, y payment.<status> para estados terminales como expired. Coincide con la cadena event, no con un análisis de subcadena.

Eventos de suscripción

Las cargas de eventos de suscripción usan una envoltura ligeramente diferente — subscription_id es un campo de nivel superior y data lleva el detalle específico del evento:

{
  "event": "subscription.renewed",
  "created_at": "2026-08-29T12:00:00Z",
  "subscription_id": "sub_abc123",
  "merchant_id": 42,
  "data": {
    "...": "event-specific fields (invoice, period dates, amount, failure reason, ...)"
  }
}

Evento	Se dispara cuando
`subscription.created`	Se creó una suscripción.
`subscription.trial_ended`	Terminó un período de prueba gratuito y comienza la facturación.
`subscription.renewed`	Una renovación programada se cobró con éxito.
`subscription.payment_failed`	Falló un cobro de renovación.
`subscription.dunning_started`	La suscripción entró en `past_due` y comenzó la secuencia de reintentos de gestión de cobros.
`subscription.suspended`	Se agotaron todos los reintentos de gestión de cobros; la suscripción está inactiva hasta que se actualice el método de pago.
`subscription.reactivated`	Se recuperó una suscripción `suspended` (nuevo método de pago o reintento exitoso).
`subscription.paused`	La suscripción se pausó manualmente.
`subscription.resumed`	Una suscripción pausada se reanudó.
`subscription.canceled`	La suscripción se canceló de forma permanente.
`subscription.completed`	La suscripción alcanzó su cantidad fija de ciclos de facturación y terminó de forma natural.
`subscription.payment_method_updated`	Se reemplazó la tarjeta almacenada en la suscripción.
`subscription.payment_method_removed`	El cliente eliminó la tarjeta guardada en la que se renueva la suscripción. La suscripción sigue cobrando esa tarjeta hasta que reemplaces su método de pago. `data.token` es el token.
`subscription.plan_change_scheduled`	Se encoló un cambio de plan para aplicarse en la próxima fecha de facturación.
`subscription.plan_changed`	Un cambio de plan entró en vigor.

Eventos de tarjetas guardadas

Los eventos de tarjetas guardadas te avisan cuando se crea un token para un pago asíncrono y cuando un token que almacenaste deja de poder usarse. Consulta el ciclo de vida del token para ver las reglas de retención.

{
  "event": "token.deleted",
  "environment": "production",
  "created_at": "2026-03-02T14:15:00Z",
  "merchant_id": 42,
  "data": {
    "token": "vt_4xK9mNpQ2rLsT7uV",
    "status": "deleted",
    "reason": "unused",
    "retentionDays": 30
  }
}

Evento	Se dispara cuando
`token.created`	Se guardó una tarjeta que se retuvo hasta que un pago asíncrono se resolvió. `data.token` es el id del token (un string, como en `token.deleted`), con `data.payment_id`, `data.payment_code`, `data.expirationDate` y `data.tokenCreationReference`. Si la misma tarjeta ya estaba guardada, `data.token` es el token existente.
`token.deleted`	El cliente o un agente de soporte eliminó una tarjeta, un guardado más reciente de la misma tarjeta la reemplazó, o Therius la retiró. `data.reason` es `deleted`, `expired` o `unused`. El token sigue cobrando hasta `token.erased`; `data.retentionDays` es el período de retención que aplica.
`token.erased`	Se borraron de forma permanente los datos de la tarjeta detrás del token. El token ya no se puede cobrar.

Eventos de enlace de pago

Un enlace de pago envía sus propios eventos además de los eventos de pago anteriores. Un pago hecho en un enlace sigue enviando sus eventos payment.* habituales; los eventos payment_link.* describen lo que le pasó al enlace en sí. Usa data.payment_link_id para identificar el enlace, y data.payment_id o data.order_code para identificar el pago. Los eventos de enlace de pago usan el mismo sobre que los eventos de pago:

{
  "event": "payment_link.paid",
  "environment": "production",
  "created_at": "2026-10-15T12:00:00Z",
  "data": {
    "payment_link_id": "5b1f0a52-3c0e-4a52-9d57-0c1d7e9f2a10",
    "type": "one-time",
    "title": "Invoice 1042",
    "reference": "INV-1042",
    "merchant_id": 42,
    "status": "used",
    "uses_count": 1,
    "payment_id": "b1f2...",
    "order_code": "INV-1042",
    "payment_status": "captured",
    "amount": 1100,
    "currency": "USD",
    "exponent": 2
  }
}

Evento	Se envía cuando
`payment_link.paid`	Un pago en el enlace fue aprobado y contado como un uso. `data.status` es `used` cuando el enlace ya no puede recibir más pagos (un enlace de un solo uso, o un enlace reutilizable que alcanzó su `maxUses`); de lo contrario, `active`. En un enlace de suscripción, `data.subscription_id` es la nueva suscripción.
`payment_link.attempt_failed`	Un intento de pago en el enlace fue rechazado o terminó en error. El enlace sigue `active`, así que el pagador puede intentarlo de nuevo.
`payment_link.expired`	El enlace pasó su fecha de vencimiento sin pagarse. Se envía una sola vez, poco después de la hora de vencimiento.
`payment_link.canceled`	El enlace fue cancelado, por la API o desde el dashboard.

Campo	Descripción
`data.payment_link_id`	El ID del enlace.
`data.type`	`one-time` o `subscription`.
`data.title`, `data.reference`	El título y tu referencia, tal como se definieron al crear el enlace. `null` si no se definieron.
`data.merchant_id`, `data.uses_count`	El comercio, y cuántos pagos exitosos ha recibido el enlace hasta ahora.
`data.status`	El estado del enlace después del evento: `used`, `expired` o `canceled` (`active` en un enlace reutilizable que aún puede recibir pagos). No se envía con `payment_link.attempt_failed`.
`data.payment_id`, `data.order_code`, `data.payment_status`, `data.amount`, `data.currency`, `data.exponent`	El pago detrás del evento. Se envían con `payment_link.paid` y `payment_link.attempt_failed`. `amount` está en unidades menores.
`data.subscription_id`	Se envía con `payment_link.paid` en un enlace de suscripción.
`data.expires_at`	Se envía con `payment_link.expired`.
`data.canceled_by`	Se envía con `payment_link.canceled`: `api` o `dashboard`.

Los eventos de enlace y los eventos de pago del mismo pago son entregas separadas y pueden llegar en cualquier orden. Relaciónalos por data.order_code o data.payment_id, no por orden de llegada.

Eventos de prueba

Usa Desarrolladores → Webhooks → Enviar evento de prueba para entregar una carga de muestra de cualquier tipo de evento a tu endpoint sin crear un pago o una suscripción reales. Las entregas de prueba aparecen en Entregas recientes junto a las reales y pueden reenviarse.

Primeros pasos

Conceptos básicos

Guías

Webhooks

Asistente de IA

Plugins de e-commerce

Catálogo de eventos de webhook de Therius y sus cargas

Eventos de pago

Eventos de suscripción

Eventos de tarjetas guardadas

Eventos de enlace de pago

Eventos de prueba

​Eventos de pago

​Eventos de suscripción

​Eventos de tarjetas guardadas

​Eventos de enlace de pago

​Eventos de prueba

Eventos de pago

Eventos de suscripción

Eventos de tarjetas guardadas

Eventos de enlace de pago

Eventos de prueba