Cette section est auto-générée à partir de la spec OpenAPI agrégée côté serveur. Chaque endpoint accessible via clé API est interactif (Try it avec votre clé).

Ce que couvre cette référence

Seuls les endpoints réellement appelables avec une clé sk_live_* / sk_test_* figurent ici : création de paiements, payouts, invoices, products, settlements, etc. Schémas + Try-it complets. Les opérations réservées au dashboard (gestion d’équipe, du KYB, des terminaux POS, des clés API, sessions humaines) ne sont pas appelables via clé API et ne figurent donc pas dans cette référence. Pour ces fonctionnalités, voir le Guide marchand. Certaines ressources sont hybrides : GET accessible via clé API, mutations réservées au dashboard. Les pages concernées (whitelist-addresses, webhook-endpoints) documentent le endpoint API appelable.

Base URL

Production : https://api.pay.izichange.com
Sandbox    : https://api.sandbox-pay.izichange.com

Authentification

Authorization: Bearer sk_(live|test)_…
Voir Authentication pour le détail.

Headers communs

HeaderSensQuand
Authorization: Bearer sk_…Clé APIToutes (sauf publics)
Idempotency-Key: <string>IdempotencePOST création de ressource
X-RateLimit-*Limites de débit (en réponse)Toutes

Format réponse erreur

{
  "statusCode": 403,
  "message": "API key missing required permission(s): payouts:write",
  "code": "INSUFFICIENT_SCOPE"
}
Codes machine notables :
  • INSUFFICIENT_SCOPE (403) : clé API valide mais sans le scope requis
  • DASHBOARD_ONLY (403) : clé API utilisée sur un endpoint réservé au dashboard
  • ACCOUNT_FROZEN (401) : compte gelé, aucune opération autorisée
  • Dépassement de quota : 429 avec le header Retry-After (pas de champ code)
  • Erreur de validation : 400 / 422, détail dans message
Voir Errors pour la hiérarchie typée côté SDK.
Tous les endpoints sont préfixés /v1.