Webhooks Overview

​

What are Webhooks?

​

How it Works

1. Register a webhook endpoint in Settings > Developer
2. Subscribe to the events you want to receive
3. Receive HTTP POST requests when events occur
4. Verify the signature to ensure authenticity
5. Respond with a 2xx status code to acknowledge receipt

​

Setup

​

1. Create a Webhook Endpoint

• Endpoint URL: An HTTPS URL that will receive webhook events
• Events: Select which events you want to subscribe to

​

2. Handle Incoming Events

POST https://your-server.com/webhooks
Content-Type: application/json
User-Agent: BitByBit-Webhooks/1.0
X-BitByBit-Webhook-Id: evt_clxxxxxxxxxxxxxxxxxx
X-BitByBit-Webhook-Event: customer.created
X-BitByBit-Webhook-Timestamp: 1700000000
X-BitByBit-Webhook-Signature: t=1700000000,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd

{
  "id": "cust_abc123",
  "email": "john@example.com",
  "firstName": "John",
  "lastName": "Doe",
  "phoneNumber": "+6281234567890",
  "tags": ["vip"],
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

​

3. Respond Quickly

​

Available Events

​

Retry Policy

​

Limits

• Maximum 10 webhook endpoints per company
• Payload size up to 64 KB
• 30 second timeout per delivery
• Response body captured up to 4 KB for debugging