# Webhooks

> Transaction and credit webhook events from Bolt.

Source: https://help.boltapp.com/api-reference/guides/webhooks

This page describes what to expect when you subscribe to Bolt's [webhooks](/developers/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 [#transaction-webhook-triggers]

The following transaction endpoints trigger webhook notifications by default:

| Endpoint                                                                                                  | Triggers webhook?                                            |
| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| [Authorize a Card](https://help.boltapp.com/api-bolt/#tag/Transactions/operation/MerchantAuthorize)       | Yes; the webhook type depends on the value in `auto-capture` |
| [Capture a Transaction](https://help.boltapp.com/api-bolt/#tag/Transactions/operation/CaptureTransaction) | Yes                                                          |
| [Refund a Transaction](https://help.boltapp.com/api-bolt/#tag/Transactions/operation/refund)              | Yes                                                          |
| [Void a Transaction](https://help.boltapp.com/api-bolt/#tag/Transactions/operation/void)                  | Yes                                                          |

<Tip>
  Some endpoints allow you to skip receiving a webhook notification by setting `skip_hook_notification` to `true`.
</Tip>

## Authorization Events [#authorization-events]

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.

| Event                   | Description                                                                                                                       | Transaction status   |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| `pending`               | The payment pre-authorization was successful, and the transaction is now pending fraud review.                                    | Pending              |
| `failed_payment`        | The payment failed pre-authorization.                                                                                             | Failed Authorization |
| `payment`               | If you use automatic capture, the transaction passed authorization and fraud review, and the system captured the funds.           | Completed            |
| `auth`                  | If you use manual capture, the transaction passed authorization and fraud review, and you can begin the capture process.          | Authorized           |
| `rejected_irreversible` | The transaction failed fraud review. You cannot appeal this decision.                                                             | Permanently Rejected |
| `rejected_reversible`   | The transaction was flagged during fraud review. You can request a [re-review](https://help.boltapp.com/fraud/request-rereview/). | Recently Rejected    |

## Merchant-Initiated Events (Asynchronous) [#merchant-initiated-events-asynchronous]

| Event     | Description                                           | Transaction status |
| --------- | ----------------------------------------------------- | ------------------ |
| `capture` | A manual capture was successful.                      | Completed          |
| `credit`  | The system successfully processed a refund or credit. | Refunded           |
| `void`    | The system successfully voided this transaction.      | Cancelled          |

## Other Notifications [#other-notifications]

| Event                     | Description                                                                  |
| ------------------------- | ---------------------------------------------------------------------------- |
| `newsletter_subscription` | The customer subscribed to the merchant's newsletter.                        |
| `risk_insights`           | Information about the transaction's risk is available from the fraud review. |

## Credit Card Events (BETA) [#credit-card-events-beta]

This is in Beta for custom cart implementations, ask your implementation manager about enablement. See our [API reference](/api-reference/merchant-callback-reference/webhooks/transactionwebhooksbeta) 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 [#virtual-terminal]

Virtual Terminal does not support webhooks. To receive updates on transactions processed through Virtual Terminal, you can set up SMS or email notifications.