resource.event.
You cannot subscribe to the
link.created event with a webhook endpoint. To receive it, pass your backend URL when you configure the widget.| Event type | data.object | Description |
|---|---|---|
account.refresh_intent.succeeded | refresh_intent | Triggers when an Account is updated with the latest available movements from the bank |
account.refresh_intent.failed | refresh_intent | Triggers when an update of the movements of a specific Account fails. Only available for “Refresh On Demand” plans |
account.refresh_intent.rejected | refresh_intent | Triggers when an update of the movements of a specific Account fails because the Link credentials are invalid. Only available for “Refresh On Demand” plans |
account.refresh_intent.movements_removed | refresh_intent | Triggers when the Link’s bank deletes transactions. To enable these notifications, activate them from your dashboard. |
account.refresh_intent.movements_modified | refresh_intent | Triggers when the Link’s bank modifies transactions. To enable these notifications, activate them from your dashboard. |
account_verification.succeeded | account_verification | Triggers when the target account holder information has been retrieved successfully. |
account_verification.failed | account_verification | Triggers when the target account holder information could not be retrieved. |
account_number.deleted | account_number | Triggers when an account number is deleted. Mexico only. |
charge.succeeded | charge | Triggers when a charge is validated as successful. |
charge.failed | charge | Triggers when a charge fails due to insufficient funds, the charged amount being higher than the authorized amount, or the user disabling the authorization. |
checkout_session.finished | checkout_session | Triggers when a customer has completed a payment. The webhook contains information about the Payment including its final status. |
checkout_session.expired | checkout_session | Triggers when a customer leaves the payment flow before finishing |
invoice.created | invoice | Triggers when an invoice is created |
invoice.finalized | invoice | Triggers when an invoice is finalized and ready to be paid |
invoice.paid | invoice | Triggers on every transition to paid, whether Fintoc collected the invoice or you marked it as paid outside Fintoc |
invoice.payment_created | invoice | Triggers when a payment for an invoice starts, either from an automatic charge or from your customer using the hosted_invoice_url |
invoice.payment_failed | invoice | Triggers when an invoice payment attempt fails |
invoice.payment_succeeded | invoice | Triggers when an invoice payment attempt succeeds |
invoice.voided | invoice | Triggers when an invoice becomes void and Fintoc disables its hosted_invoice_url |
link.created | link | Triggers when a Link is created |
link.credentials_changed | link | Triggers when the credentials corresponding to a Link change and the Link needs to be reconnected |
link.refresh_intent.succeeded | refresh_intent | Triggers when a Link has been completely updated. For now, it is only triggered for electronic invoices |
payment_intent.succeeded | payment_intent | Triggers when a Payment Intent finishes successfully |
payment_intent.rejected | payment_intent | Triggers when a user rejects a Payment Intent |
payment_intent.expired | payment_intent | Triggers when a user doesn’t complete a Payment Intent |
payment_intent.failed | payment_intent | Triggers when a Payment Intent fails |
payment_intent.pending | payment_intent | Triggers when the final status of the payment is not available yet. A future webhook will be sent with the final status once it’s determined. |
payout.created | payout | Triggers when a Payout is created and starts processing |
payout.succeeded | payout | Triggers when a Payout is successfully transferred to your bank account |
payout.canceled | payout | Triggers when a Payout is canceled and will not be sent to your bank account |
payout.returned | payout | Mexico only Triggers when a previously successful Payout is returned from your bank account. Resources included in such payout should typically be included in the next one |
refund.in_progress | refund | Triggers when a Refund starts processing. |
refund.succeeded | refund | Triggers when a Refund is successfully processed |
refund.failed | refund | Triggers when a Refund fails |
subscription_intent.succeeded | subscription_intent | Triggers when a subscription intent is validated as successful. The subscription_intent includes the resulting subscription object. |
subscription_intent.failed | subscription_intent | Triggers when a subscription intent fails due to a problem with the bank or Fintoc. |
subscription_intent.rejected | subscription_intent | Triggers when a subscription intent is rejected by the user. This may happen when the user rejects the MFA step or if it is entered incorrectly. |
subscription.activated | subscription | Triggers when the bank has confirmed that the subscription is ready to accept charges. |
subscription.canceled | subscription | Triggers when the bank informs Fintoc that the subscription has been canceled. |
subscription.payment_method_updated | subscription | Triggers when Fintoc attaches a new payment method to the subscription through a CheckoutSession with flow: setup or with PATCH /v2/subscriptions/{id}. For a new pac, the bank may still be activating the mandate; check the payment method’s pac.status to confirm it is chargeable. |
subscription.payment_method_update_failed | subscription | Triggers when the bank rejects activation of a new payment method mandate. The subscription keeps the new, failed payment method with no automatic rollback, and open invoices stay collectible through each invoice’s hosted_invoice_url. |
transfer.outbound.succeeded | transfer | Triggers when the Transfer successfully settles. |
transfer.outbound.returned | transfer | 🇲🇽 In Mexico: Triggers when either Banco de Mexico or the counterparty institution has rejected the transfer. 🇨🇱 In Chile: Triggers when the counterparty institution has rejected the transfer. |
transfer.outbound.failed | transfer | Triggers when the transfer has not been able to reach its destination account, due to an error during the process. |
transfer.inbound.succeeded | transfer | Triggers when a Transfer is successfully received in your account. |
transfer.inbound.returned | transfer | 🇲🇽 Triggers when an Inbound Transfer has been returned by the recipient. |
transfer.inbound.rejected | transfer | 🇲🇽 Triggers when an Inbound Transfer has been rejected before being credited to your account. |
Invoice payment events
An invoice reachespaid in two ways, and the events differ. When Fintoc collects the invoice, you receive invoice.payment_succeeded and then invoice.paid. When you mark the invoice as paid because your customer paid you outside Fintoc, you receive invoice.paid alone.
Read external_payment in the payload to tell the two apart. The value is false when the money went through Fintoc and true when it did not.