paid-python

library1.10.0pypypi✓ verified 84d ago

Official Python SDK for the Paid API (https://paid.ai). Provides sync and async clients to manage subscriptions, orders, checkouts, webhooks, customer portal sessions, credit balances, and more. Currently at version 1.8.0, with frequent releases adding new sub-clients. Requires Python >=3.10 <3.14.

payments

pip install paid-python

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · PAID-PYTHON

paid-python

paymentspythonv1.10.0

Install

7.5s avg

Import

799ms

Disk

52MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.10.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.828s · 52.6MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 7.5s · import 0.770s · 53MB

52MB installed

● package 52MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Paid

✓ from paid import Paid

✗ import paid

Paid is a class in the paid package, not a module to import directly.

AsyncPaid

✓ from paid import AsyncPaid

✗ from paid.async_client import AsyncPaid

AsyncPaid is exported from the top-level paid package.

Initialize the sync client and list products. Async client is `from paid import AsyncPaid` with same instantiation.

from paid import Paid client = Paid( api_key=os.environ.get('PAID_API_KEY', ''), ) # List products products = client.products.list() print(products)

Debug

Known issues

gotchaThe SDK uses fern-generated client patterns. Do not instantiate sub-clients directly (e.g., `client.products` not `Products(client)`). Always access sub-resources via the main client.

fix

Use `client.products.list()` instead of `Products(client).list()`.

affects: >=1.0.0

gotchaAPI key must be passed explicitly or via environment variable `PAID_API_KEY`. The SDK does not automatically read from environment.

fix

Set `PAID_API_KEY` environment variable or pass `api_key='sk-...'` to the client constructor.

affects: >=1.0.0

deprecatedThe `create_checkout` method on the Checkouts client now accepts an optional `currency` parameter (added in 1.7.2). Previous versions may ignore currency.

fix

Upgrade to >=1.7.2 and pass `currency='usd'` to `client.checkouts.create()`.

affects: <1.7.2

Errors

Common errors & fixes

AttributeError: module 'paid' has no attribute 'Paid'

Importing incorrectly, e.g., `import paid` instead of `from paid import Paid`.

fix

Use `from paid import Paid`.

PaidAPIError: Unauthorized

Missing or invalid API key.

fix

Ensure `api_key` is set correctly via constructor or environment variable `PAID_API_KEY`.

TypeError: Client.__init__() missing 1 required positional argument: 'api_key'

Instantiating client without an API key.

fix

Pass `api_key='sk-...'` or set `PAID_API_KEY` environment variable.

ModuleNotFoundError: No module named 'paid'

Package not installed or installed in wrong environment.

fix

Run `pip install paid-python` in the correct Python environment.

Upgrade

Version history

1.10.0latest on PyPI · released May 22, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

19 hits · last 30 days

node

Resources

githubhttps://github.com/paid-ai/paid-python ↗

packagehttps://pypi.org/project/paid-python/ ↗

homepagehttps://paid.ai ↗