Python SDK

The official Chargebee Python SDK provides a convenient way to interact with the Chargebee API from your Python applications.

Installation

Requirements

Python 3.11 or later

Quick Start

Create a Resource

List & Pagination

Use Filters for typed filtering and next_offset for pagination:

Idempotent Requests

Pass an idempotency key as a header in the third argument:

Error Handling

Retry & Rate Limits

Retries are disabled by default. Enable with RetryConfig:

Rate-limited responses (HTTP 429) are automatically retried after the Retry-After duration.

OpenTelemetry

Request telemetry is supported in all Chargebee client libraries. Pass a telemetry adapter when configuring the client to emit standardized spans (chargebee.{resource}.{operation}) with OTel HTTP and chargebee.* attributes.

See OpenTelemetry integration for span attributes and language-specific examples.

Migration Guide

If upgrading from v2 to v3, see the migration guide.