Python SDK

The Paddle Python SDK integrates Paddle Billing with Python applications. It handles pagination automatically, exposes operation classes for creates and updates, and includes a webhook signature verifier that works with Flask, Django, and anything speaking the request protocol.

Requirements

Python 3.11 or later.

Install

pip install paddle-python-sdk

poetry add paddle-python-sdk

uv add paddle-python-sdk

Authenticate

Create an API key in Paddle > Developer tools > Authentication, then pass it when you construct the client.

API keys are environment-specific. Use a sandbox key for sandbox, a live key for production.

from os import getenv
from paddle_billing import Client, Environment, Options

paddle = Client(
    getenv('PADDLE_API_KEY'),
    options=Options(Environment.SANDBOX),
)

Omit the options argument, or use Environment.PRODUCTION, to use the live API.

Make your first request

List the products in your catalog:

from os import getenv
from paddle_billing import Client, Environment, Options

paddle = Client(
    getenv('PADDLE_API_KEY'),
    options=Options(Environment.SANDBOX),
)

products = paddle.products.list()

for product in products:
    print(product.id, product.name)

paddle.products.list() returns an iterator. Iterating with for ... in walks every page automatically. The SDK fetches the next page when the current one is exhausted.

Next steps

• Understand shared patterns for pagination, idempotency, retries, and error handling across SDKs.
• Browse the API reference for every resource and operation the SDK exposes.
• Work against sandbox while you build, then follow the go-live checklist to switch environments.