Installation & Configuration

The official Python SDK for the Felloh payments API. Use it to manage bookings, transactions, payment links, and all other Felloh resources from your Python backend.

- PyPI Package

- Github Repository

Installation

The SDK requires Python 3.10 or later. It uses httpx for async HTTP requests.

pip install felloh

Quick Start

import asyncio
from felloh import FellohClient
from felloh.types import FellohConfig

client = FellohClient(FellohConfig(
    public_key="your-public-key",
    private_key="your-private-key",
))

async def main():
    bookings = await client.bookings.list({
        "organisation": "your-org-id",
    })
    print(bookings["data"])
    await client.close()

asyncio.run(main())

Configuration Options

from felloh import FellohClient
from felloh.types import FellohConfig

client = FellohClient(FellohConfig(
    public_key="your-public-key",
    private_key="your-private-key",
    base_url="https://api.felloh.com",
    timeout=30.0,
    max_retries=2,
    token_refresh_buffer=60,
    logger=lambda entry: print(
        f"{entry.method} {entry.url} → "
        f"{entry.status_code} ({entry.duration_ms:.0f}ms)"
    ),
))

Token Management

The SDK automatically handles JWT token acquisition and refresh. Tokens are cached in memory and proactively refreshed before expiry based on the token_refresh_buffer setting. No manual token management is needed.

If a request receives a 401 response, the SDK will automatically refresh the token and retry the request once. Token refreshes are serialised using an asyncio.Lock to prevent concurrent refresh requests.

Available Resources

Every resource on the Felloh API is accessible through an attribute on the client instance.