Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.delegare.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Python SDK

The Delegare Python SDK provides robust, type-safe clients for interacting with the Delegare API. It includes fully synchronous and asynchronous implementations, Pydantic v2 typing, and seamless x402 auto-payment routines.

​
Installation

pip install delegare

​
Quick Start

import os
from delegare import Delegare, ApiKeyAuth, ChargeRequest

auth = ApiKeyAuth(
    merchant_id=os.environ.get("DELEGARE_MERCHANT_ID"),
    api_key=os.environ.get("DELEGARE_API_KEY")
)

with Delegare(auth) as client:
    charge = client.charge(ChargeRequest(
        amountCents=500,
        currency="usd",
        intentMandate="mandate_123",
        idempotencyKey="idem_123",
        description="Data extraction"
    ))
    
    print(f"Charge ID: {charge.receipt_id}")
    print(f"Status: {charge.status}")

​
Features

​
Synchronous and Asynchronous Clients

The SDK natively supports Delegare and AsyncDelegare implementations, giving you parity regardless of whether you’re using asyncio or standard synchronous scripts.

​
X402 Auto-Payment

You can use the built-in .fetch() utility to automatically process any HTTP requests that return 402 Payment Required headers. The client automatically retrieves the accepts schema, makes the corresponding charge against the provided intent mandate, and retries the request seamlessly. 
response = client.fetch(
    "https://api.example.com/premium-endpoint", 
    intent_mandate="mandate_123"
)
print(response.json())