📍 Bolt Help / Core Products / Accounts / Direct API / Use Webhook Events (Optional)

Use Webhook Events (Optional)

Subscribe to transaction webhooks to receive transaction updates.

Bolt uses a transaction webhooks service to update when payment status changes occur. Within the webhook delivery system, Bolt can directly integrate into APIs set up on your module.

To leverage these webhooks, build out a receiving endpoint that maps between Bolt’s transaction statuses and your order statuses.

Bolt Status Definition
pending Payment has been authorized / order created.
authorized Payment is ready to capture.
completed Payment has been fully captured.
cancelled Payment has been voided.
rejected_irreversible Payment is fully rejected for suspected fraud.
rejected_reversible Payment is conditionally rejected for suspected fraud. You may choose to manually approve.


Refunded is not a transaction status. It is a separate transaction object that shows the completed refund.

Next Steps

After you’re done setting things up, you can use Bolt’s Test Card References to confirm all transaction scenarios are working as expected.

📖On This Page
Filter by Section
Filter by Topic