Démarrage rapide

Créez une clé API, initiez un paiement et vérifiez le résultat en quelques minutes.

1. Prérequis

Votre marchand doit être ACTIVE avec KYB APPROVED et un wallet provisionné.

Créez une clé sandbox dans le menu Développeurs, section Clés API. Le secret commence par izzi_mk_sandbox_.

Après approbation KYB, les mises à jour opérationnelles passent par PATCH /merchant-owner/onboarding/profile/operational ; les changements légaux par PATCH /merchant-owner/onboarding/profile/material-change (repasse le dossier en SUBMITTED).

2. URL de base

Toutes les requêtes ciblent l'API de votre tenant. La base URL affichée ci-dessous inclut déjà le préfixe /api/v1 : ne le répétez pas dans vos clients.

Exemple : si la base est https://api.example.com/api/v1, appelez POST …/checkout/sessions et non …/api/v1/checkout/sessions.

text

https://api.izzi-finance.com/api/v1

3. Lister vos charges

Smoke test avec votre clé API et l'identifiant marchand (MERCHANT_ID). Les listes retournent data comme tableau et meta pour la pagination :

bash

curl -X GET https://api.izzi-finance.com/api/v1/merchant/merchants/$MERCHANT_ID/charges?limit=10 \
  -H "Authorization: Bearer izzi_mk_sandbox_…" \
  -H "Content-Type: application/json"

4. OpenAPI

Schéma Swagger interactif via la passerelle tenant : GET https://api.izzi-finance.com/api/v1/docs (UI) et GET https://api.izzi-finance.com/api/v1/docs-json (JSON).

Utile pour générer des clients ou valider les payloads avant intégration.

SDK Node officiel : npm install @izzipay/sdk

5. Créer une session checkout

Alternative recommandée pour encaisser côté client. La réponse contient sessionId et url.

Checkout hébergé : redirigez le payeur vers data.url (voir guide Checkout hébergé).

Checkout API : utilisez data.id (sessionId) dans votre UI et appelez POST /checkout/pay/:sessionId/complete (voir guide Checkout API).

bash

curl -X POST https://api.izzi-finance.com/api/v1/checkout/sessions \
  -H "Authorization: Bearer izzi_mk_sandbox_…" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "2500",
    "currency": "USD",
    "title": "Commande test",
    "successUrl": "https://example.com/success"
  }'