paylio 0.1.7

Python client library for the Paylio API

Paylio Python SDK

The Paylio Python SDK provides convenient access to the Paylio API from applications written in Python.

Documentation

See the Paylio API docs.

Requirements

• Python 3.9+

Installation

pip install paylio

Usage

import paylio

client = paylio.PaylioClient("sk_live_xxx")

# Retrieve current subscription
sub = client.subscription.retrieve("user_123")
print(sub.status)       # "active"
print(sub.plan.name)    # "Pro Plan"
print(sub.plan.amount)  # 999

List subscription history

history = client.subscription.list("user_123", page=1, page_size=10)
for item in history.items:
    print(item.plan_name, item.status)

if history.has_more:
    next_page = client.subscription.list("user_123", page=2)

Cancel a subscription

# Cancel at end of billing period (safe default)
result = client.subscription.cancel("subscription_uuid")
print(result.success)  # True

# Cancel immediately
result = client.subscription.cancel("subscription_uuid", cancel_now=True)

Context manager

with paylio.PaylioClient("sk_live_xxx") as client:
    sub = client.subscription.retrieve("user_123")

Configuration

client = paylio.PaylioClient(
    "sk_live_xxx",
    base_url="https://api.paylio.pro/flying/v1",
)

Error handling

import paylio

client = paylio.PaylioClient("sk_live_xxx")

try:
    sub = client.subscription.retrieve("user_123")
except paylio.AuthenticationError:
    print("Invalid API key")
except paylio.NotFoundError:
    print("Subscription not found")
except paylio.RateLimitError:
    print("Rate limited, try again later")
except paylio.InvalidRequestError as e:
    print(f"Bad request: {e.message}")
except paylio.APIError as e:
    print(f"API error: {e.message} (status {e.http_status})")
except paylio.APIConnectionError:
    print("Network error")

Error types

Error	HTTP Status	Description
AuthenticationError	401	Invalid or missing API key
InvalidRequestError	400	Bad request parameters
NotFoundError	404	Resource not found
RateLimitError	429	Rate limit exceeded
APIError	5xx	Server error
APIConnectionError	—	Network or connection failure

All errors inherit from PaylioError.

Development

pip install -e ".[dev]"
pytest
ruff check .
mypy .

License

MIT