Docs
API 2026-05-27.dahlia Dashboard

Webhooks

Every event type Fluveo sends to webhook endpoints, when it is sent and the object it carries.

Fluveo sends an event to your webhook endpoints each time something below happens, and lists the last 30 days of events on GET /v1/events. Each event's data.object is the object named here, as it was at that moment; an update also carries data.previous_attributes. An endpoint gets only the types in its enabled_events, or all of them with *.

Typedata.object
account.updatedaccount
balance.availablebalance
charge.capturedcharge
charge.dispute.closeddispute
charge.dispute.createddispute
charge.dispute.funds_reinstateddispute
charge.dispute.funds_withdrawndispute
charge.dispute.updateddispute
charge.expiredcharge
charge.failedcharge
charge.refund.updatedrefund
charge.refundedcharge
charge.succeededcharge
charge.updatedcharge
checkout.session.async_payment_failedcheckout.session
checkout.session.async_payment_succeededcheckout.session
checkout.session.completedcheckout.session
checkout.session.expiredcheckout.session
customer.createdcustomer
customer.deletedcustomer
customer.tax_id.createdtax_id
customer.tax_id.deletedtax_id
customer.tax_id.updatedtax_id
customer.updatedcustomer
payment_intent.amount_capturable_updatedpayment_intent
payment_intent.canceledpayment_intent
payment_intent.createdpayment_intent
payment_intent.payment_failedpayment_intent
payment_intent.processingpayment_intent
payment_intent.requires_actionpayment_intent
payment_intent.succeededpayment_intent
payment_link.createdpayment_link
payment_link.updatedpayment_link
payment_method.attachedpayment_method
payment_method.detachedpayment_method
payment_method.updatedpayment_method
payout.canceledpayout
payout.createdpayout
payout.failedpayout
payout.paidpayout
payout.updatedpayout
price.createdprice
price.updatedprice
product.createdproduct
product.deletedproduct
product.updatedproduct
radar.early_fraud_warning.createdradar.early_fraud_warning
radar.early_fraud_warning.updatedradar.early_fraud_warning
refund.createdrefund
refund.failedrefund
refund.updatedrefund
reserve.hold.createdreserve.hold
reserve.hold.updatedreserve.hold
reserve.plan.createdreserve.plan
reserve.plan.disabledreserve.plan
reserve.plan.expiredreserve.plan
reserve.plan.updatedreserve.plan
reserve.release.createdreserve.release
setup_intent.canceledsetup_intent
setup_intent.createdsetup_intent
setup_intent.requires_actionsetup_intent
setup_intent.setup_failedsetup_intent
setup_intent.succeededsetup_intent

account events#

account.updated#

Sent when the store's Account changed; previous_attributes holds the old values. data.object is a account object.

balance events#

balance.available#

Sent when money in the store's balance became available to pay out. data.object is a balance object.

charge events#

charge.captured#

Sent when an authorized charge was captured. data.object is a charge object.

charge.dispute.closed#

Sent when a dispute ended, won or lost. data.object is a dispute object.

charge.dispute.created#

Sent when a buyer disputed a charge. data.object is a dispute object.

charge.dispute.funds_reinstated#

Sent when the disputed amount came back to the store's balance. data.object is a dispute object.

charge.dispute.funds_withdrawn#

Sent when the disputed amount was taken from the store's balance. data.object is a dispute object.

charge.dispute.updated#

Sent when a dispute changed, for example after evidence was sent. data.object is a dispute object.

charge.expired#

Sent when an authorization ran out before it was captured. data.object is a charge object.

charge.failed#

Sent when a payment attempt was declined or failed. data.object is a charge object.

charge.refund.updated#

Sent when a refund of the charge changed. data.object is a refund object.

charge.refunded#

Sent when a charge was refunded, in full or in part. data.object is a charge object.

charge.succeeded#

Sent when a payment attempt succeeded. data.object is a charge object.

charge.updated#

Sent when a charge's description or metadata changed, or its balance transaction was booked (about 3 s after the sale; not sent when a refund came first). data.object is a charge object.

checkout events#

checkout.session.async_payment_failed#

Sent when the Boleto of a complete Checkout Session expired unpaid. data.object is a checkout.session object.

checkout.session.async_payment_succeeded#

Sent when the Boleto of a complete Checkout Session was paid. data.object is a checkout.session object.

checkout.session.completed#

Sent when the buyer paid through a Checkout Session, or issued its Boleto (then payment_status is unpaid). data.object is a checkout.session object.

checkout.session.expired#

Sent when a Checkout Session expired without payment. data.object is a checkout.session object.

customer events#

customer.created#

Sent when a customer was created. data.object is a customer object.

customer.deleted#

Sent when a customer was deleted. data.object is a customer object.

customer.tax_id.created#

Sent when a tax ID was added to a customer. data.object is a tax_id object.

customer.tax_id.deleted#

Sent when a tax ID was removed from a customer. data.object is a tax_id object.

customer.tax_id.updated#

Sent when the check of an au_abn, eu_vat or gb_vat tax ID finished; data.object.verification holds the result and previous_attributes the old values. data.object is a tax_id object.

customer.updated#

Sent when a customer changed. data.object is a customer object.

payment_intent events#

payment_intent.amount_capturable_updated#

Sent when an authorization is held and waits for a manual capture. data.object is a payment_intent object.

payment_intent.canceled#

Sent when a PaymentIntent was canceled. data.object is a payment_intent object.

payment_intent.created#

Sent when a PaymentIntent was created. data.object is a payment_intent object.

payment_intent.payment_failed#

Sent when a payment attempt on the PaymentIntent failed. data.object is a payment_intent object.

payment_intent.processing#

Sent when the payment is being processed and its result is not known yet. data.object is a payment_intent object.

payment_intent.requires_action#

Sent when the buyer must act before the payment can go on, for example to pass 3D Secure. data.object is a payment_intent object.

payment_intent.succeeded#

Sent when the payment succeeded. data.object is a payment_intent object.

payment_link.created#

Sent when the store created a payment link. data.object is a payment_link object.

payment_link.updated#

Sent when a payment link changed, such as being switched off; previous_attributes holds the old values. data.object is a payment_link object.

payment_method events#

payment_method.attached#

Sent when a payment method was attached to a customer. data.object is a payment_method object.

payment_method.detached#

Sent when a payment method was detached from a customer. data.object is a payment_method object.

payment_method.updated#

Sent when a payment method changed. data.object is a payment_method object.

payout events#

payout.canceled#

Sent when a payout was canceled. data.object is a payout object.

payout.created#

Sent when a payout was created. data.object is a payout object.

payout.failed#

Sent when a payout failed and the money returned to the balance. data.object is a payout object.

payout.paid#

Sent when a payout reached the bank. data.object is a payout object.

payout.updated#

Sent when a payout changed. data.object is a payout object.

price events#

price.created#

Sent when a price was created, alone or with its product. data.object is a price object.

price.updated#

Sent when a price changed, also when another price took its lookup_key; previous_attributes holds the old values. data.object is a price object.

product events#

product.created#

Sent when a product was created, alone or through a price's product_data. data.object is a product object.

product.deleted#

Sent when a product was deleted. data.object is a product object.

product.updated#

Sent when a product changed; previous_attributes holds the old values. data.object is a product object.

radar events#

radar.early_fraud_warning.created#

Sent when a card issuer warned that a charge of the store is likely fraud. data.object is a radar.early_fraud_warning object.

radar.early_fraud_warning.updated#

Sent when an early fraud warning changed, such as actionable turning false after a full refund; previous_attributes holds the old values. data.object is a radar.early_fraud_warning object.

refund events#

refund.created#

Sent when a refund was created. data.object is a refund object.

refund.failed#

Sent when a refund failed. data.object is a refund object.

refund.updated#

Sent when a refund changed. data.object is a refund object.

reserve events#

reserve.hold.created#

Sent when money from a sale was held back in the reserve of the store's account. data.object is a reserve.hold object.

reserve.hold.updated#

Sent when a reserve hold changed, such as its release date or the part still held. data.object is a reserve.hold object.

reserve.plan.created#

Sent when a reserve plan was set up on the store's account. data.object is a reserve.plan object.

reserve.plan.disabled#

Sent when a reserve plan was turned off and its holds are being released. data.object is a reserve.plan object.

reserve.plan.expired#

Sent when a reserve plan reached its end and its holds are being released. data.object is a reserve.plan object.

reserve.plan.updated#

Sent when a reserve plan's terms changed. data.object is a reserve.plan object.

reserve.release.created#

Sent when money held in the reserve was released: on its date, early, or by a refund or dispute. data.object is a reserve.release object.

setup_intent events#

setup_intent.canceled#

Sent when a SetupIntent was canceled. data.object is a setup_intent object.

setup_intent.created#

Sent when a SetupIntent was created. data.object is a setup_intent object.

setup_intent.requires_action#

Sent when the buyer must pass 3D Secure before the card is set up. data.object is a setup_intent object.

setup_intent.setup_failed#

Sent when setting up a card failed: a decline or a failed 3D Secure; last_setup_error says which. data.object is a setup_intent object.

setup_intent.succeeded#

Sent when a card was set up and attached to the SetupIntent's customer. data.object is a setup_intent object.