Webhooks - BuckBus

Webhooks allow you to track transaction updates related to your store. You can use webhooks to update your database records for successful or cancelled payments. BucksBus will send webhook events when a payment is created, completed, cancelled, or any time a payment is received.

To receive webhooks, you need to subscribe to your store in Store -> Settings -> Webhooks in the Webhook URL field. You will be asked to enter the URL of the endpoint (HTTPS only) where you want to receive webhooks. You can choose whether to receive notifications for all events or only for those that interest you.

Before sending webhook data, BucksBus will check the security of the connection to your service, so your server must be properly configured to support HTTPS.

Your endpoint must respond with a 200 HTTP status code to confirm acceptance of the webhook. If confirmation of receipt is not received, we will retry up to ten times. The maximum interval between such attempts is one hour.

Buckbus will sign each webhook event it sends to your endpoints. The signature will be included in the X-Webhook-HMAC-SHA256 header. This header will contain the SHA256 HMAC signature of the raw request payload, calculated using your webhook secret as the key. If the webhook secret is not populated, the signature in the header will not be sent.

{
  "type": "notification",
  "event": "payment.cancel",
  "payment": {
    "payment_id": "75d53a6c-0158-42d0-b69d-593691ef75f0",
    "store_id": "5f65375b-30ac-4cef-9383-795f5aa49911",
    "account_id": "b3c9d200-bef3-4f4e-a967-e0c8587065f8",
    "store_name": "Main",
    "payment_num": "67",
    "payment_type": "FIXED_AMOUNT",
    "payment_type_name": "Fixed Amount",
    "is_test": false,
    "amount": "10400",
    "asset_id": "USD",
    "paid_amount": "0",
    "payment_amount": "0.09601501",
    "payment_asset_id": "BTC",
    "rate": 0.00000923221233289743,
    "rate_date": "2025-07-08T09:21:34Z",
    "ip_amount": "0",
    "ip_asset_id": "BTC",
    "status": "CANCEL",
    "status_name": "Expired",
    "address_id": "5293adbc-ef74-4115-bb41-bb57ba7fce4b",
    "address": "test_address",
    "confirms": 6,
    "start_date": "2025-07-08T09:22:07Z",
    "end_date": "2025-07-08T10:22:07Z",
    "payment_url": "https://example.com/payment/75d53a6c-0158-42d0-b69d-593691ef75f0?code=649defde-d7e0-4395-88fe-fb8b68adfa91",
    "qrcode_url": "https://example.com/int/payment/75d53a6c-0158-42d0-b69d-593691ef75f0/qrcode?code=649defde-d7e0-4395-88fe-fb8b68adfa91&oi=daee91ff-d4b7-4bb1-8c4a-855f57f9af6b&l=0",
    "payer_email": "123@example.com",
    "payer_name": "123@example.com",
    "payer_lang": "en",
    "custom": "",
    "webhook_url": "https://example.com/?wc-api=WC_Gateway_BucksBus",
    "timeout": 60,
    "creation_date": "2025-07-08T09:22:07Z",
    "created_by": "TEST",
    "updated_date": "2025-07-08T11:22:47Z"
  }
}