Tipos de eventos

Esta es una lista de todos los tipos de eventos que enviamos actualmente. Podemos agregar más en cualquier momento, así que al desarrollar y mantener tu código no debes asumir que solo existen estos tipos. Ten en cuenta que los eventos siguen una especie de patrón en su nomenclatura: resource.event. Nuestro objetivo es contar con un sistema consistente para que su uso te resulte intuitivo y fácil.

link.created es el único evento que no puede escucharse mediante un Webhook Endpoint. Para recibir dicho evento, debes pasar la URL de tu backend a la que quieras enviarlo al configurar el widget.

Tipo de evento	`data.object`	Descripción
`account.refresh_intent.succeeded`	`refresh_intent`	Se dispara cuando una `Account` se actualiza con los últimos movimientos disponibles del banco
`account.refresh_intent.failed`	`refresh_intent`	Se dispara cuando falla la actualización de los movimientos de una `Account` específica. Solo disponible para planes “Refresh On Demand”
`account.refresh_intent.rejected`	`refresh_intent`	Se dispara cuando falla la actualización de los movimientos de una `Account` específica porque las credenciales del `Link` no son válidas. Solo disponible para planes “Refresh On Demand”
`account.refresh_intent.movements_removed`	`refresh_intent`	Se dispara cuando el banco del Link elimina transacciones. Para habilitar estas notificaciones, actívalas desde tu dashboard.
`account.refresh_intent.movements_modified`	`refresh_intent`	Se dispara cuando el banco del Link modifica transacciones. Para habilitar estas notificaciones, actívalas desde tu dashboard.
`account_verification.succeeded`	`account_verification`	Se dispara cuando la información del titular de la cuenta destino se obtuvo correctamente.
`account_verification.failed`	`account_verification`	Se dispara cuando la información del titular de la cuenta destino no pudo obtenerse.
`account_number.deleted`	`account_number`	Se dispara cuando se elimina un account number. Solo en México.
`charge.succeeded`	`charge`	Se dispara cuando un charge se valida como exitoso.
`charge.failed`	`charge`	Se dispara cuando un charge falla por fondos insuficientes, porque el monto cobrado supera el monto autorizado, o porque el usuario deshabilitó la autorización.
`checkout_session.finished`	`checkout_session`	Se dispara cuando un cliente completa un pago. El webhook contiene información sobre el Payment incluyendo su estado final.
`checkout_session.expired`	`checkout_session`	Se dispara cuando un cliente abandona el flujo de pago antes de finalizar
`invoice.created`	`invoice`	Se dispara cuando se crea una invoice
`invoice.finalized`	`invoice`	Se dispara cuando una invoice se finaliza y está lista para ser pagada
`invoice.paid`	`invoice`	Se dispara en toda transición a `paid`, ya sea que Fintoc haya cobrado la invoice o que tú la hayas marcado como pagada fuera de Fintoc
`invoice.payment_created`	`invoice`	Se dispara cuando comienza un pago de una invoice, ya sea desde un cobro automático o desde tu cliente usando el `hosted_invoice_url`
`invoice.payment_failed`	`invoice`	Se dispara cuando falla un intento de pago de una invoice
`invoice.payment_succeeded`	`invoice`	Se dispara cuando un intento de pago de una invoice resulta exitoso
`invoice.voided`	`invoice`	Se dispara cuando una invoice se anula y Fintoc deshabilita su `hosted_invoice_url`
`link.created`	`link`	Se dispara cuando se crea un `Link`
`link.credentials_changed`	`link`	Se dispara cuando las credenciales asociadas a un `Link` cambian y es necesario reconectar el `Link`
`link.refresh_intent.succeeded`	`refresh_intent`	Se dispara cuando un `Link` se ha actualizado por completo. Por ahora, solo se dispara para facturas electrónicas
`payment_intent.succeeded`	`payment_intent`	Se dispara cuando un `Payment Intent` finaliza exitosamente
`payment_intent.rejected`	`payment_intent`	Se dispara cuando un usuario rechaza un `Payment Intent`
`payment_intent.expired`	`payment_intent`	Se dispara cuando un usuario no completa un `Payment Intent`
`payment_intent.failed`	`payment_intent`	Se dispara cuando un `Payment Intent` falla
`payment_intent.pending`	`payment_intent`	Se dispara cuando el estado final del pago aún no está disponible. Se enviará un webhook posterior con el estado final una vez que se determine.
`payout.created`	`payout`	Se dispara cuando se crea un `Payout` y comienza a procesarse
`payout.succeeded`	`payout`	Se dispara cuando un `Payout` se transfiere exitosamente a tu cuenta bancaria
`payout.canceled`	`payout`	Se dispara cuando un `Payout` se cancela y no será enviado a tu cuenta bancaria
`payout.returned`	`payout`	Solo México Se dispara cuando un `Payout` previamente exitoso es devuelto desde tu cuenta bancaria. Los recursos incluidos en ese payout normalmente deberían incluirse en el siguiente
`refund.in_progress`	`refund`	Se dispara cuando un `Refund` comienza a procesarse.
`refund.succeeded`	`refund`	Se dispara cuando un `Refund` se procesa exitosamente
`refund.failed`	`refund`	Se dispara cuando un `Refund` falla
`subscription_intent.succeeded`	`subscription_intent`	Se dispara cuando un subscription intent se valida como exitoso. El `subscription_intent` incluye el objeto `subscription` resultante.
`subscription_intent.failed`	`subscription_intent`	Se dispara cuando un subscription intent falla por un problema con el banco o con Fintoc.
`subscription_intent.rejected`	`subscription_intent`	Se dispara cuando un subscription intent es rechazado por el usuario. Esto puede suceder cuando el usuario rechaza el paso de MFA o si lo ingresa incorrectamente.
`subscription.activated`	`subscription`	Se dispara cuando el banco confirma que la subscription está lista para aceptar charges.
`subscription.canceled`	`subscription`	Se dispara cuando el banco informa a Fintoc que la subscription ha sido cancelada.
`subscription.payment_method_updated`	`subscription`	Se dispara cuando Fintoc asocia un método de pago nuevo a la suscripción a través de una `CheckoutSession` con `flow: setup` o con `PATCH /v2/subscriptions/{id}`. Si el método nuevo es un `pac`, el banco puede seguir activando el mandato; revisa `pac.status` en el objeto `PaymentMethod` para confirmar si ya es cobrable.
`subscription.payment_method_update_failed`	`subscription`	Se dispara cuando el banco rechaza la activación de un mandato de método de pago nuevo. La suscripción se queda con el método de pago fallido, sin volver automáticamente al anterior, y las invoices abiertas se pueden cobrar mediante el `hosted_invoice_url` de cada una.
`transfer.outbound.succeeded`	`transfer`	Se dispara cuando la Transfer se liquida exitosamente.
`transfer.outbound.returned`	`transfer`	🇲🇽 En México: se dispara cuando el Banco de México o la institución contraparte rechaza la transferencia. 🇨🇱 En Chile: se dispara cuando la institución contraparte rechaza la transferencia.
`transfer.outbound.failed`	`transfer`	Se dispara cuando la transfer no pudo llegar a su cuenta destino, debido a un error durante el proceso.
`transfer.inbound.succeeded`	`transfer`	Se dispara cuando una Transfer se recibe exitosamente en tu cuenta.
`transfer.inbound.returned`	`transfer`	🇲🇽 Se dispara cuando una Inbound Transfer ha sido devuelta por el destinatario.
`transfer.inbound.rejected`	`transfer`	🇲🇽 Se dispara cuando una Inbound Transfer ha sido rechazada antes de ser acreditada en tu cuenta.

Eventos de pago de una invoice

Una invoice llega a paid de dos formas, y los eventos son distintos. Cuando Fintoc cobra la invoice, recibes invoice.payment_succeeded y después invoice.paid. Cuando marcas la invoice como pagada porque tu cliente te pagó fuera de Fintoc, recibes solo invoice.paid. Lee external_payment en el payload para distinguir los dos casos. El valor es false cuando la plata pasó por Fintoc y true cuando no.

​Eventos de pago de una invoice

Eventos de pago de una invoice