Webhook Setup

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.

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

Bolt offers two methods for configuring webhook subscriptions.

Webhook Configuration API

Refer to the Webhooks endpoints (/v1/webhooks) to configure subscriptions via the Bolt API.

Merchant Dashboard

1. Log in to your Bolt Merchant Dashboard.
2. Navigate to Administration.
3. Under Developers, select Webhooks.
4. Add your webhook endpoints.
5. Verify the authenticity of requests 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

• Webhook events reference
• Verify webhooks
• Review webhook failures
• API keys