Démarrage
Les montants sont des chaînes décimales (ex.
"10000"), jamais des number. La clé API détermine l’environnement : sk_test_… (sandbox) ou sk_live_… (production).Pagination
Les endpoints de listing renvoient{"data": [...], "nextCursor": ...}. L’itérateur iterate parcourt toutes les pages via le curseur :
Vérification d’un webhook
validate_webhook attend le corps brut (bytes/str), pas un dict re-sérialisé. Signature X-IziPay-Signature: sha256=<hex> (HMAC-SHA256), tolérance anti-replay 300 s.
Erreurs
Toutes les erreurs héritent deIzichangepayError. Branchez sur le type :
| Type | Quand |
|---|---|
AuthError | 401 / 403 |
NotFoundError | 404 |
ValidationError | 422 (.fields) |
RateLimitError | 429 (.retry_after) |
ServerError | 5xx |
NetworkError | pas de réponse (DNS, timeout) |
WebhookError | signature / timestamp invalides (.reason) |
Ressources disponibles
payment_intents, payouts, invoices, products, settlements, settlement_accounts, wallet, merchant_assets, payins, assets, merchants, webhook_endpoints, whitelist_addresses.