orb-billing

What it is and what it does

orb-billing is the official Python client for the Orb billing platform API. It wraps Orb's REST endpoints with type-safe request and response objects, offering both synchronous and asynchronous clients powered by httpx. The library includes full type hints for IDE autocomplete, Pydantic models for responses with serialization helpers, and built-in pagination support for list operations.

Developers use it to integrate Orb's subscription billing, metering, and invoicing into Python applications. The library handles authentication via API keys, automatic retries on transient failures, webhook signature verification, and detailed error types for different HTTP status codes. It supports modern Python versions (3.9 through 3.14) and runs on all major operating systems.

Use it for:

• Create and manage customer accounts and billing addresses in Orb from a Python backend.
• Fetch paginated lists of coupons, subscriptions, or invoices with automatic page handling.
• Handle incoming Orb webhooks with built-in signature verification to ensure authenticity.
• Build async billing workflows using the AsyncOrb client with optional aiohttp backend for concurrency.
• Catch and handle specific API errors (rate limits, auth failures, validation errors) with typed exception classes.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library for the Orb billing REST API, providing typed request and response objects with both synchronous and asynchronous interfaces.

Yes. The library is actively maintained, has no known vulnerabilities, low install friction, and permissive licensing. Install it if you are building a Python application that integrates with Orb's billing platform and want type-safe, well-documented API access.

Install

orb-billing on PyPI

pip install orb-billing

uv add orb-billing

poetry add orb-billing

Installing orb-billing

Before you install

Low install friction with a pure-Python wheel and six common runtime dependencies. Actively maintained with a release within the past week and recent commits.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart

pip install orb-billing

import os
from orb import Orb

client = Orb(api_key=os.environ.get("ORB_API_KEY"))
customer = client.customers.create(
    email="example@withorb.com",
    name="My Customer"
)
print(customer.id)

Requires Python 3.9 or later; API key must be provided via environment variable or constructor argument.

Verify before relying

• Whether the library's auto-retry behavior (2 times by default) is configurable for production use cases.
• Performance characteristics and latency overhead of the typed Pydantic response layer under high throughput.
• Whether webhook verification helpers work with all common Python web frameworks beyond FastAPI.

Package facts

Evidence: orb_billing-4.68.0-py3-none-any.whl

Tags

More Python Modules packages