# Webhook Setup

> Configure webhooks for transaction and credit card update events from Bolt.

Source: https://help.boltapp.com/developers/webhooks

Bolt webhooks notify your server when checkout events happen. After you register an endpoint, Bolt sends POST requests when you subscribe to those events.

Event types and payloads are documented in [Bolt Webhooks](/api-reference/guides/webhooks).

## Webhook use cases [#webhook-use-cases]

Common reasons to use webhooks:

* Notifying your store when a transaction is approved or rejected by Bolt
* Sending your store the `transaction_id` for back-office operations
* Sending transaction details such as credit card metadata

## Set up webhooks [#set-up-webhooks]

Bolt offers two methods for configuring webhook subscriptions.

### Webhook Configuration API [#webhook-configuration-api]

Refer to the [Webhooks endpoints](https://help.boltapp.com/api-bolt/#tag/Webhooks) (`/v1/webhooks`) to configure subscriptions via the Bolt API.

### Merchant Dashboard [#merchant-dashboard]

1. Log in to your Bolt [Merchant Dashboard](https://merchant.boltapp.com).
2. Navigate to **Administration**.
3. Under **Developers**, select **Webhooks**.
4. Add your webhook endpoints.
5. [Verify the authenticity of requests](/api-reference/guides/verify-webhooks) to confirm they originated from Bolt.

If the response to a webhook request is not **HTTP 200 OK** or the response body is not valid JSON, Bolt retries with exponential back-off.

## Related [#related]

* [Webhook events reference](/api-reference/guides/webhooks)
* [Verify webhooks](/api-reference/guides/verify-webhooks)
* [Review webhook failures](/api-reference/guides/webhook-failures)
* [API keys](/getting-started/api-keys)