izichangepay 0.1.0

Official Python SDK for the IzichangePay API.

izichangepay (Python SDK)

Official Python SDK for the IzichangePay API. Zero dependencies (standard library only), Python ≥ 3.8.

pip install izichangepay

Usage

import os
from izichangepay import Client, SANDBOX_BASE_URL

izipay = Client(api_key=os.environ["IZIPAY_API_KEY"])
# Sandbox: Client(api_key=..., base_url=SANDBOX_BASE_URL)

intent = izipay.payment_intents.create({
    "requestedCurrencyType": "fiat",
    "currencyRequested": "XOF",
    "amountRequested": "10000",
    "acceptedCoins": ["USDT.TRC20"],
})
print(intent["paymentUrl"])

Pagination

for intent in izipay.payment_intents.iterate({"limit": 50}):
    print(intent["id"])

Verifying a webhook

from izichangepay import validate_webhook, WebhookError

# `raw_body` must be the raw bytes/str, not a re-serialized dict.
try:
    event = validate_webhook(
        raw_body,
        request.headers.get("X-IziPay-Signature"),
        os.environ["IZIPAY_WEBHOOK_SECRET"],
    )
    # handle event["type"] / event["data"]
except WebhookError as err:
    ...  # reject: err.reason

Errors

All errors subclass IzichangepayError. Specific types: AuthError (401/403), NotFoundError (404), ValidationError (422, .fields), RateLimitError (429, .retry_after), ServerError (5xx), NetworkError, WebhookError.

Features

• Bearer auth, auto JSON (de)serialization
• Auto Idempotency-Key on POST, retry on 429/5xx/network with backoff + jitter
• Constant-time webhook signature verification + anti-replay window
• Cursor pagination iterators

Documentation

Full reference: https://docs.pay.izichange.com/developers/sdks/python

License

MIT