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

# Reseller Customer Billing

> Connect customer plans in Vida with Stripe or Chargebee subscriptions, renewals, access, and supported usage charges.

Eligible resellers and partners can connect a billing provider to charge downstream customers for
their Vida plans. Vida keeps the customer's selected plan and product usage aligned with the
subscription lifecycle, while the connected provider processes payment and remains the system of
record for invoices and payment methods.

<Note>
  Billing-provider configuration is optional and is not available to ordinary organization or Agent
  accounts. Contact Vida if your reseller or partner account needs this capability enabled.
</Note>

## What the integration supports

Depending on the provider and account configuration, Vida can coordinate:

* hosted customer checkout
* new subscriptions
* renewals
* upgrades and downgrades
* cancellation
* customer payment-method and invoice access through the provider portal
* account access based on subscription state
* supported usage overages added to the appropriate billing cycle

The provider controls payment collection, retries, invoice delivery, taxation settings, and its
customer portal. Vida controls the relationship between the customer account, plan, Agents, usage,
and enabled product experience.

## Choose a provider

Vida supports reseller customer billing through:

* [Stripe](/docs/billing/stripe)
* [Chargebee](/docs/billing/chargebee)

Connect the provider to the reseller or partner account that owns the downstream customer plans.
Provider credentials and product identifiers should come from the corresponding production billing
account after a test configuration has been verified.

## Prepare the customer plans

For each Vida plan:

1. define its customer-facing name and price
2. choose the included product items and usage amounts
3. create the corresponding product and recurring price in the billing provider
4. record the provider product and price identifiers
5. connect those identifiers to the matching Vida plan

Use the current Vida product catalog when choosing product items. Do not copy obsolete item IDs from
an old plan or document.

## Configure the provider safely

1. Complete the provider's checkout and customer-portal settings.
2. Create the required webhook destination and events.
3. Create production credentials with the required access.
4. Read any existing Vida billing-provider configuration before replacing it.
5. Save the complete provider configuration to the owning reseller or partner account.
6. Read it back and verify the provider type and masked credential fields.

Saving a new configuration replaces the complete existing provider configuration. Keep the full
intended setup available during credential rotation.

## Test the complete lifecycle

Use a designated customer to verify:

* checkout and initial activation
* payment success and failure behavior
* customer portal access
* plan upgrades and downgrades
* cancellation and renewal
* included usage and supported overage handling
* Agent access after subscription changes

Test the customer-facing branded experience, not only provider-side API calls.

Customer billing and Vida reseller payouts are separate workflows. See
[Reseller Billing and Payouts](/docs/enablement/reseller-billing-and-payouts).

<Note>
  Configuring billing through the API? See the
  [Billing Provider API guide](/docs/api-reference/platform-guides/billing-providers).
</Note>