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 Développeurs → 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. Utilisez la base URL affichée ci-dessous une seule fois ; la référence API utilise des chemins relatifs /api/v1/…

text

https://api.dev.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.dev.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 : GET https://api.dev.izzi-finance.com/api/v1/docs (UI) et GET https://api.dev.izzi-finance.com/api/v1/docs-json (JSON).

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

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.dev.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"
  }'