Ruby SDK

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

Installation

Requirements

Ruby 1.9.3 or later

Quick Start

Create a Resource

List & 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 via retry_config on the default environment:

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.