Events
The 21 subscribable merchant event types and their versioned payloads.
Subscribe to the event types your integration handles. Each event page describes the business fact, money semantics, complete envelope and data fields, schema versions, and example payloads.
Invoice events#
| Event | Meaning |
|---|---|
| invoice.created | Invoice intent created; no funds accepted |
| invoice.detected | A payment was observed before acceptance |
| invoice.confirming | An accepted partial payment leaves the invoice below the paid threshold |
| invoice.paid | The accepted total meets the payment threshold |
| invoice.overpaid | The accepted total exceeds the overpayment threshold |
| invoice.underpaid | Closed with part of the amount accepted; usually no new credit, reconcile amount_paid from the invoice |
| invoice.expired | Unpaid window expired |
| invoice.invalid | An unaccepted observation was dropped or reorged |
| invoice.rejected | A timely payment cannot be accepted and nothing was accepted; the invoice is closed |
| invoice.late_payment | A payment was accepted late |
| invoice.payment_reversed | A previously accepted payment was reversed |
Payout events#
| Event | Meaning |
|---|---|
| payout.completed | Transfer completed |
| payout.failed | Transfer failed; reservation released |
| payout.reversed | Completed transfer reversed by the chain |
Refund events#
| Event | Meaning |
|---|---|
| refund.created | Refund created; funds reserved |
| refund.completed | Refund transfer completed |
| refund.failed | Refund failed; reservation released |
| refund.reversed | Completed refund lost chain confirmation; reconcile delivery |
Conversion events (live only)#
| Event | Meaning |
|---|---|
| conversion.completed | Standalone conversion settled; merchant credit booked |
| conversion.failed | First failure; recovery may follow |
| conversion.source_restored | Source returned/released or refused before debit |
Events outside the catalog#
webhook.ping is a synthetic test delivery, not a subscription. There is no merchant balance.credited, payout.created, or merchant-status event in this contract.
Delivery rules are documented in webhooks; processing guidance is in business processes.