Skip to main content
Connect Chargebee so invoices can include a ZBX cryptocurrency pay link.

​
Auto charge

ZBX does not auto-charge crypto. Use wallet / pay link flows for collection. For automatic crypto charging, create an appropriate pay link in the dashboard and complete the customer wallet consent path where required.

​
Enable the integration

​
Chargebee API key

  1. In Chargebee: Settings → Configure Chargebee → API keys → Add API key.
  2. Choose a full-access key covering the resources you need.
  3. Name it (for example “ZBX integration”) and create the key. Store it securely.

​
Connect in ZBX

  1. Open the merchant dashboard.
  2. Go to Settings → Integration, find Chargebee, Connect.
  3. Enter your Chargebee site / domain and the API key.
  4. Confirm Connect.
Copy the webhook URL shown after connect for the next step.

​
Webhooks

Chargebee can poll/sync on an interval. For near real-time updates, add a webhook:
  1. Chargebee Settings → Configure Chargebee → Webhooks → Add webhook.
  2. Name it and set the URL in this form:
Use the exact URL provided in the ZBX integration UI if it differs slightly from the pattern above.
  1. Turn off basic-auth protection, primary-flag-only behaviour, and card data exclusion as directed in the product UI for this integration.
  2. Send all events (or the set required by support).
  3. Create the webhook.
Provision Chargebee custom fields so crypto metadata is searchable and mergeable. Field keys below use the published integration names:

​
Customer

​
Charge / plan price

Fields are not all strictly required, but provisioning the full set gives the best reporting experience. See Chargebee’s custom field docs for setup.

​
Test a payment

  1. Complete a test payment on a pay link in the correct environment.
  2. Open Invoices in Chargebee and confirm payment details landed.

​
Subscriptions

When creating Chargebee subscriptions that use ZBX:
  1. Ensure the integration is connected.
  2. Create products/plans and customers in Chargebee as usual.
  3. Avoid auto-charge modes that only apply to card.
  4. Confirm invoices show the crypto pay link metadata after sync.
Contact support if invoice pay links do not appear after connection.