Paddle

1.13.0 · active · verified Sun Mar 01

Official Python SDK for Paddle Billing (the new Paddle platform). PyPI package is paddle-python-sdk, imports as paddle_billing. Requires Python >=3.11. Note: there are two Paddle platforms — Paddle Classic (legacy) and Paddle Billing (current). This SDK is Paddle Billing only.

Warnings

breaking Paddle Classic (old platform) and Paddle Billing (new platform) are entirely different APIs with different SDKs. This SDK (paddle-python-sdk) is Paddle Billing only. If your account is on Paddle Classic, this SDK will not work.
Fix: Check your Paddle dashboard. Paddle Classic shows 'Paddle Classic' branding. Billing uses api.paddle.com endpoints. Classic uses vendors.paddle.com. There is no official Python SDK for Paddle Classic — use requests against the REST API directly.
breaking Requires Python >=3.11. Installing on Python 3.10 or lower will fail at install time or raise a RuntimeError.
Fix: Upgrade to Python 3.11+.
gotcha Package name is paddle-python-sdk but import module is paddle_billing. 'import paddle' or 'from paddle import ...' will fail — 'paddle' is not the module name.
Fix: from paddle_billing import Client
gotcha Sandbox and live API keys are separate credentials. Using a live key against the sandbox environment (or vice versa) returns 401 or unexpected data.
Fix: Generate separate API keys in your Paddle Sandbox account and your live account.
gotcha Paddle Billing list() methods return iterators, not lists. Code that indexes the result directly (products[0]) raises TypeError.
Fix: Iterate with for product in paddle.products.list() or convert with list(paddle.products.list()).

Install

pip install paddle-python-sdk Python (requires Python >=3.11)

Imports

Client
```
from paddle_billing import Client

paddle = Client('PADDLE_API_SECRET_KEY')
```
Package is paddle-python-sdk, module is paddle_billing. There is no 'paddle' importable module from this package.
Sandbox environment
```
from paddle_billing import Client, Environment, Options

paddle = Client('PADDLE_API_SECRET_KEY', options=Options(Environment.SANDBOX))
```
Sandbox is passed via Options(Environment.SANDBOX), not a boolean flag. Sandbox API keys are separate from live keys.

Quickstart

Paddle Billing SDK. Import module is paddle_billing, not paddle.

from paddle_billing import Client

paddle = Client('PADDLE_API_SECRET_KEY')

# List products
products = paddle.products.list()
for product in products:
    print(f'{product.id}: {product.name}')

# Verify webhook signature
from paddle_billing.Notifications import Secret, Verifier

integrity_check = Verifier().verify(request, Secret('WEBHOOK_SECRET_KEY'))

view raw JSON →