payagentic 0.1.0

PayAgentic Python SDK — Agent payments for AI agents

payagentic

Official Python SDK for PayAgentic — programmable USDC wallets for AI agents that pay external APIs over x402.

Install

pip install payagentic
# or
uv add payagentic
poetry add payagentic

Requires Python 3.13+.

Usage

Sync

from payagentic import PayAgentic

client = PayAgentic(api_key="pa_test_…")
# Or from env: PAYAGENTIC_API_KEY, PAYAGENTIC_AGENT_ID, PAYAGENTIC_BASE_URL

wallets = client.wallets.list_wallets()
payment = client.payments.propose_payment(body={...})
status = client.payments.get_payment(id=payment.id)

# x402 paywall walker
response = client.x402.fetch("https://api.vendor.com/paid-endpoint")

Async

from payagentic import AsyncPayAgentic

async with AsyncPayAgentic(api_key="pa_test_…") as client:
    wallets = await client.wallets.list_wallets()
    response = await client.x402.fetch("https://api.vendor.com/paid-endpoint")

Typed errors

Non-2xx responses raise typed exceptions you can catch by type:

from payagentic import PayAgentic, UnauthorizedError, RateLimitError, ValidationError

try:
    client.wallets.list_wallets()
except UnauthorizedError:
    ...
except RateLimitError:
    ...

Full hierarchy: PayAgenticError → {Conflict, Forbidden, Internal, Network, NotFound, RateLimit, ServiceUnavailable, Unauthorized, Validation}Error. Use payagentic.is_retryable(err) for retry classification.

Mandate signer

from payagentic import LocalMandateSigner

signer = LocalMandateSigner.from_pem("path/to/key.pem")
mandate = signer.sign({...})

Pydantic models

All request/response shapes are Pydantic v2 models, re-exported under payagentic.models:

from payagentic.models import Wallet, PaymentResponse, MandateListItem

Generated transport

The HTTP transport in src/payagentic/_generated/ is generated by openapi-python-client from the gateway's OpenAPI spec at ../../api/openapi.json. Regenerate with the monorepo's just gen-sdk-py.

src/payagentic/_generated/ is marked linguist-generated=true. Don't edit those files directly — modify the gateway's #[utoipa::path] annotations + regenerate.

Development (from the monorepo)

just gen-sdk-py    # regenerate from api/openapi.json
cd sdks/python
uv run pytest
uv run mypy src/payagentic
uv run ruff check src tests
uv build

Publishing

just release-py 0.1.0   # bumps version, builds, uv publish, tags

Needs PyPI API token in ~/.config/uv/credentials.toml or UV_PUBLISH_TOKEN env.

License

MIT