This page describes what to expect when you subscribe to Bolt’s webhooks.
Get updates on status changes as a transaction moves through lifecycle stages. All transaction events correspond to the
transaction webhook object type.
Transaction Webhook Triggers
The following transaction endpoints trigger webhook notifications by default:
|Authorize a Card||Yes; the webhook type depends on the value in
|Capture a Transaction||Yes|
|Refund a Transaction||Yes|
|Void a Transaction||Yes|
Some endpoints allow you to skip receiving a webhook notification by setting
When our automated risk review system approves transactions, you receive the status immediately. If the transaction is flagged for manual review, you receive the status in a webhook notification.
||The payment pre-authorization was successful, and the transaction is now pending fraud review.||Pending|
||The payment failed pre-authorization.||Failed Authorization|
||If you use automatic capture, the transaction passed authorization and fraud review, and the system captured the funds.||Completed|
||If you use manual capture, the transaction passed authorization and fraud review, and you can begin the capture process.||Authorized|
||The transaction failed fraud review. You cannot appeal this decision.||Permanently Rejected|
||The transaction was flagged during fraud review. You can request a re-review.||Recently Rejected|
Merchant-Initiated Events (Asynchronous)
||A manual capture was successful.||Completed|
||The system successfully processed a refund or credit.||Refunded|
||The system successfully voided this transaction.||Cancelled|
||The customer subscribed to the merchant’s newsletter.|
||Information about the transaction’s risk is available from the fraud review.|
Get updates on subscriptions, offers, and orders.
Refer to Subscriptions for terminology and use cases.
|Event||Webhook Object Type||Description|
||A shopper purchased a physical or digital subscription.|
||A shopper’s subscription has been cancelled, either by the merchant or the shopper. Cancellation is effective immediately, and no additional order renewals will occur.|
||An automatic renewal of a subscription order on its defined schedule. This webhook notifies the merchant that the subscription is current and renewing as intended.|
Subscription Webhook Triggers
The following subscription endpoints trigger webhook notifications by default:
Credit Card Events (BETA)
This is in Beta for custom cart implementations, ask your implementation manager about enablement. See our API reference for more information.
credit_card_deleted: A customer removed a saved credit card from their account. This webhook is for custom cart implementations and is only available to beta merchants.
Virtual Terminal does not support webhooks. To receive updates on transactions processed through Virtual Terminal, you can set up SMS or email notifications.