---
id: chargebee
version: "3.27.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# chargebee — Python wrapper for the Chargebee Subscription Billing API

License: unclear · Maintenance: active · Downloads: 1.1M/mo

## What it is and what it does

Chargebee is the official Python client for Chargebee's subscription billing platform. It wraps the Chargebee REST API, allowing developers to manage customers, subscriptions, invoices, and other billing entities directly from Python code. The library supports both synchronous and asynchronous HTTP operations via httpx, with configurable timeouts, retry logic, and idempotency keys for safe request retries.

The SDK provides typed request and response objects, resource-specific and global enums, custom field support, and filtering for list operations. It includes built-in retry handling for transient errors (5xx status codes) with exponential backoff, rate-limit awareness via Retry-After headers, and methods to wait for long-running operations like exports and time-travel requests to complete.

Use it for:

- Build a SaaS platform that manages customer subscriptions, billing cycles, and payment methods through Chargebee.
- Automate customer creation, plan changes, and invoice management in a subscription-based business.
- Integrate Chargebee billing data into internal dashboards or reporting systems via async API calls.
- Handle idempotent payment operations safely by using idempotency keys to prevent duplicate charges.
- Export large customer or transaction datasets and wait for completion before processing results.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Official Python client library for integrating with the Chargebee subscription billing API, supporting both synchronous and asynchronous HTTP requests.

Yes. The library is actively maintained, has low install friction, requires only httpx as a dependency, and is the official client for Chargebee's API. It supports modern Python (3.11+) and offers both sync and async patterns. No known vulnerabilities. License treatment is unclear, so verify licensing terms with your legal team before use in commercial projects.

## Install

pip install chargebee
uv add chargebee
poetry add chargebee

## Installing chargebee

Before you install: Low install friction with a single runtime dependency (httpx). Actively maintained with a release 15 days ago. Requires Python 3.11 or later.

Quickstart:

pip install chargebee

from chargebee import Chargebee

cb_client = Chargebee(api_key="your_api_key", site="your_site")
response = cb_client.Customer.create(
    cb_client.Customer.CreateParams(first_name="John", email="john@test.com")
)
print(response.customer)

Requires Python 3.11 or later; API key and site name from Chargebee account required to initialize client.

Verify before relying:

- Whether the library's async support is production-ready or still experimental beyond version 3.9.0
- Scope and stability of custom field support across different Chargebee account configurations
- Rate limiting behavior and retry defaults when retry logic is disabled

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

chargebee api client, subscription billing python, chargebee python sdk, recurring billing integration, chargebee api wrapper, subscription management api, billing platform integration, billing-api, subscription-management, async-support

[View on SkillFed](https://skillfed.io/packages/chargebee) · [View on PyPI](https://pypi.org/project/chargebee/)