Webhook

BillingTab Webhook

​

Webhook endpoint for receiving billing tab events.

This endpoint receives webhooks sent by the billing tab service. The webhook contains information about the failure, including error details and billing tab information.

Body·
required
application/json
  • billing_tab
    Type: object ·
    required
  • callback_id
    Type: string
    required

    Unique identifier generated for each callback.

  • callback_timestamp
    Type: stringFormat: date-time
    required

    An ISO 8601 compliant timestamp for the callback.

  • callback_type
    const:  
    BillingTab
    required

    The type of callback. Value is "BillingTab" for billing tab callbacks.

  • event
    Type: object ·
    required
Responses
  • application/json
Request Example for postBillingTab
{
  "callback_id": "89c41740-5eb6-40bb-8ec3-02be196de6da",
  "callback_timestamp": "2025-12-19T07:52:35.620151Z",
  "callback_type": "BillingTab",
  "billing_tab": {
    "customer_number": "5",
    "id": "3b668ece-3941-6555-faf8-c7a082adb4c9"
  },
  "event": {
    "type": "BillogramCreationError",
    "response": {
      "data": {
        "message": "invalid delivery method, address missing"
      },
      "status": "INVALID_PARAMETER"
    }
  }
}

{
  "status": "OK"
}

Webhook received successfully.

Required: Your endpoint must return HTTP 200 OK for the webhook to be considered successfully delivered. Any other status code will cause the webhook to be marked as failed and retried.