Events

List and replay webhook events linked to your account.

Events are created on every state change. They correspond directly to webhook payloads.

Endpoints

Method	Path	Description
`GET`	`/events`	List events
`GET`	`/events/{id}`	Retrieve an event
`POST`	`/events/{id}/resend`	Resend an event

The Event object

idstringoptional

Unique event identifier.

typestringoptional

Event type (e.g. `payment.succeeded`, `transfer.succeeded`).

dataobjectoptional

Event payload — contains the resource object.

created_atdatetimeoptional

ISO 8601 timestamp.

Naming isn't perfectly uniform

Most event types use dot notation (payment.succeeded), but refund creation/failure and payment link events use an underscore instead (refund_created, link_created). Match on the exact string in the tables below rather than assuming a single pattern.

Event catalog

Payments

Type	Trigger
`payment.created`	Payment initialized
`payment.processing`	Payment submitted to the provider
`payment.succeeded`	Payment validated
`payment.failed`	Payment failed
`payment.cancelled`	Cancelled by the customer or expired
`payment.split.processing`	A payment split (installment) started processing
`payment.split.succeeded`	A payment split succeeded
`payment.split.failed`	A payment split failed

Refunds

Type	Trigger
`refund_created`	Refund created — underscore, not `refund.created`
`refund.processing`	Refund submitted to the operator
`refund.succeeded`	Refund confirmed
`refund_failed`	Refund failed — underscore, not `refund.failed`
`refund.cancelled`	Refund cancelled

Transfers

Type	Trigger
`transfer.created`	Transfer created
`transfer.processing`	Submitted to the operator
`transfer.succeeded`	Delivered
`transfer.failed`	Failed

Customers

Type	Trigger
`customer.created`	Created
`customer.updated`	Updated
`customer.deleted`	Deleted

Beneficiaries

Type	Trigger
`beneficiary.created`	Created
`beneficiary.updated`	Updated
`beneficiary.deleted`	Deleted

Invoices

Type	Trigger
`invoice.created`	Created
`invoice.updated`	Updated (sent, marked paid, cancelled, …)
`invoice.deleted`	Deleted

Payment links

Type	Trigger
`link_created`	Created — underscore, not `link.created`
`link_updated`	Updated
`link_deleted`	Deleted

Accounts (Sync / subaccounts)

Type	Trigger
`account.created`	Sub-account created
`account.updated`	Sub-account updated
`account.deauthorized`	Sub-account removed or access revoked
`account.payment_activated`	Payment capability enabled
`account.payment_suspended`	Payment capability suspended

Disputes

Type	Trigger
`dispute.created`	New dispute opened
`dispute.updated`	Dispute updated
`dispute.won`	Resolved in your favor
`dispute.lost`	Resolved against you
`dispute.closed`	Closed
`dispute.deleted`	Deleted

Webhook endpoints

Type	Trigger
`webhook_endpoint.created`	Endpoint registered
`webhook_endpoint.updated`	Endpoint updated
`webhook_endpoint.deleted`	Endpoint removed

Other

Type	Trigger
`balance.updated`	Available/pending/reserved balance changed
`fee.received`	A platform fee was collected (Sync)

WebhooksConfigure real-time event reception.