Promise lifecycle
The stages a ticket promise goes through from creation to resolution.
Every promise on Promise Tickets goes through a lifecycle of statuses. Understanding these statuses helps you know where things stand.
Promise statuses
| Status | Meaning | |--------|---------| | Active | The promise has been made and the card is saved. Waiting for the campaign to convert or expire. | | Converted | The campaign was converted and the card was successfully charged. Tickets are confirmed. | | Failed | The campaign was converted but the card charge was declined. Tickets were not issued. | | Cancelled | The patron cancelled the promise before conversion. The card was released. |
Lifecycle flow
A promise always starts as active and ends in one of three terminal states:
- Active → Converted — The campaign converted and the charge succeeded.
- Active → Failed — The campaign converted but the charge was declined.
- Active → Cancelled — The patron cancelled, or the campaign expired/was cancelled.
Key points
- A promise can only be in one status at a time.
- Once a promise reaches a terminal status (converted, failed, or cancelled), it cannot change again.
- Patrons can only cancel an active promise — not one that has already been converted or failed.
- When a campaign expires, all active promises are automatically moved to cancelled.
Producers can see the status of every promise on their campaign detail page in the dashboard.