OxaPay Python Client

A fully-typed Python client for the OxaPay cryptocurrency payment gateway v1 API.

Features

• 🚀 Async-first with sync wrapper
• 🔒 Full type hints & Pydantic models
• 🌐 Complete API coverage (Merchant, Payout, Swap, System)
• 🔄 Litestar webhook integration

Installation

pip install oxapay

For webhook handling:

pip install "oxapay[webhook]"

Quick Start

Create an Invoice

import asyncio
from oxapay import OxaPayClient, CreateInvoiceRequest

async def main():
    async with OxaPayClient(merchant_api_key="your_key") as client:
        invoice = CreateInvoiceRequest(
            amount=100,
            currency="USD",
            order_id="order_123"
        )
        response = await client.create_invoice(invoice)
        print(f"Payment URL: {response.data.payment_url}")
        print(f"Track ID: {response.data.track_id}")

asyncio.run(main())

Sync Client

from oxapay.sync import SyncOxaPayClient, CreateInvoiceRequest

client = SyncOxaPayClient(merchant_api_key="your_key")
response = client.create_invoice(
    CreateInvoiceRequest(amount=100, currency="USD")
)
print(response.data.payment_url)

Webhooks

from litestar import Litestar
from oxapay.webhook import WebhookRouter, PaymentWebhookEvent

webhook = WebhookRouter(
    merchant_api_key="your_key",
    path="/webhook"
)

app = Litestar(route_handlers=[webhook.router])

@webhook.on_payment_paid
async def handle_payment(event: PaymentWebhookEvent):
    print(f"Payment received: {event.track_id}")

API Coverage

• Merchant: Invoices, white-label, static wallets, payment info
• Payout: Send crypto, track payouts, balances
• Swap: Exchange rates, swap requests
• System: Prices, currencies, networks, status

Examples

See the examples/ directory for more detailed usage patterns.

License

MIT License - see LICENSE file for details.