Eventos
Consulta el historial de cambios y los tipos de evento.
Consultar eventos
| Método | Ruta | Acción |
|---|---|---|
| GET | /v1/events | Listar; admite filtro type |
| GET | /v1/events/:event | Consultar evento |
Eventos por flujo
| Flujo | Eventos principales |
|---|---|
| Compra | checkout.completed, checkout.expired |
| Pago | payment.succeeded, payment.failed, payment.refunded |
| Reembolso | refund.created, refund.failed |
| Reclamo | claim.created, claim.updated, claim.resolved, claim.withdrawn |
| Cobro | invoice.created, invoice.paid, invoice.voided, invoice.uncollectible |
| Suscripción | subscription.created, subscription.updated, subscription.renewal_due, subscription.renewed, subscription.past_due, subscription.suspended, subscription.reactivated, subscription.canceled, subscription.expired, subscription.change_failed |
| Cliente | customer.created, customer.updated, customer.member_added, customer.member_removed |
| Catálogo | product.updated, product.deleted, payment_link.deleted |
| Prueba | webhook_endpoint.test |
Esta versión también tiene los eventos de retiro (payout.created, payout.paid, payout.failed y payout.canceled), pero ya no llegan: Billete no guarda saldo, porque envía el neto de cada pago al Pago Móvil de tu negocio al confirmarse.
Los eventos de entrega completan el seguimiento de compras físicas. El objeto del recurso viene en data; el evento también incluye id, type, environment, createdAt y apiVersion, la versión en cuya forma viene data: la de tu petición en GET /v1/events, o la del endpoint en un webhook. customer.member_* traen el miembro; subscription.change_failed trae { subscription, checkoutId }: el cambio pagado no se aplicó y Billete solicitó el reembolso de ese pago. webhook_endpoint.test trae el endpoint (sin su secreto) y solo llega cuando lo envías desde el dashboard a un endpoint, esté o no suscrito a él: no describe nada de tu negocio, así que ignóralo o úsalo para comprobar tu verificación.