> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zbx.boomfi.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe Billing

> Add ZBX crypto paylinks to Stripe Billing invoices and subscriptions.

Connect [Stripe Billing](https://stripe.com/) so invoices can include a cryptocurrency pay link generated by ZBX.

## Auto charge

ZBX does **not** implement Stripe auto-charge for crypto. To charge a customer automatically in crypto, create a recurring pay link in the [dashboard](https://merchants.zbx.boomfi.xyz/) and have the customer complete wallet connection / signature where required.

## Enable the integration

1. Sign in to **Stripe**.
2. Open **Developers → API keys** and copy a secret key for the environment you want to connect.
3. Sign in to ZBX and open **Settings → Integration**.
4. Find **Stripe** and choose **Connect**.
5. Paste the Stripe API key and confirm integration.

The integration should register a Stripe webhook endpoint automatically. Confirm it under Stripe **Developers → Webhooks**. If missing, add an endpoint using the webhook URL shown in the ZBX integration UI.

Using Stripe webhooks is strongly recommended because relying only on API polling can hit rate limits.

## Subscriptions with Stripe

### Prerequisites

Confirm Stripe appears as connected under Integrations.

### Create a product (optional)

1. In Stripe, open **Product catalog → Add product**.
2. Set name and price, then save.

ZBX can generate a pay link and attach it as metadata on the price / related invoices.

### Create a subscription

1. Open **Customers**, select the customer, then **Create subscription**.
2. Attach the product.
3. Under **Subscription settings**, turn **off** auto charge and invoice payment-page auto behaviour that ZBX cannot process.

<Warning>
  Invoices left on auto-charge for card will be ignored for crypto processing.
</Warning>

After setup, open an invoice and confirm the pay link metadata. When the customer pays successfully on the ZBX checkout, the Stripe invoice is marked **Paid** and crypto payment details are attached.

## Related

* [Integrations Overview](/integrations/overview)
* [Payment Links](/payments/paylinks)
* [Webhooks Overview](/webhooks/overview)