Se faire reverser en mobile money

Un reversement (settlement) convertit une partie de votre solde crypto en monnaie locale et l’envoie sur un compte de retrait déclaré au préalable. Scope requis : settlements:write (settlements:read pour devis et lecture)

1. Vérifier ce qui est reversable

curl https://api.izichangepay.com/v1/settlements/settleable-assets \
  -H "Authorization: Bearer $IZIPAY_API_KEY"

Toutes les cryptos de votre solde ne sont pas reversables : cela dépend des partenaires disponibles pour votre pays et votre devise.

2. Demander un devis

Le taux de change bouge. Demandez toujours un devis avant de confirmer :

curl -G https://api.izichangepay.com/v1/settlements/quote \
  -H "Authorization: Bearer $IZIPAY_API_KEY" \
  --data-urlencode "assetCode=USDT.TRC20" \
  --data-urlencode "amount=500.00" \
  --data-urlencode "settlementAccountId=c7a1…"

Le devis indique le montant fiat estimé, le taux et les frais. Il est indicatif :

Le taux définitif est celui du moment de l’exécution, pas celui du devis. Entre les deux, le marché a pu bouger. Le montant réellement crédité est fiatAmountFinal dans le webhook settlement.completed — c’est lui que vous devez comptabiliser, jamais le devis.

3. Créer le reversement

curl -X POST https://api.izichangepay.com/v1/settlements \
  -H "Authorization: Bearer $IZIPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assetCode": "USDT.TRC20",
    "amountCrypto": "500.00",
    "settlementAccountId": "c7a1…",
    "merchantReference": "settlement_juillet",
    "idempotencyKey": "settlement_juillet"
  }'

Champ	Requis	Sens
`assetCode`	✅	La crypto à convertir.
`amountCrypto`	✅	Le montant crypto à convertir, en chaîne.
`settlementAccountId`	✅	Le compte de retrait qui recevra les fonds.
`merchantReference`		Votre référence.
`idempotencyKey`		Rejouer la même clé retourne le reversement déjà créé.
`totpCode`		Code 2FA à 6 chiffres. Requis pour les appels par session dashboard, pas par clé API.

Vous indiquez un montant en crypto, pas en fiat. Le montant fiat en découle, au taux du moment.

4. Suivre l’issue

Événement	Sens
`settlement.created`	Reversement enregistré, conversion à venir.
`settlement.completed`	Fonds envoyés sur votre compte de retrait.
`settlement.failed`	Échec — la raison est dans `data.object.failureReason`.
`settlement.relaunched`	Un reversement bloqué a été relancé.

{
  "event": "settlement.completed",
  "timestamp": 1731843299,
  "data": {
    "settlementId": "5e44…",
    "merchantId": "9a20…",
    "object": {
      "id": "5e44…",
      "assetCode": "USDT.TRC20",
      "amountCrypto": "500.00",
      "fiatCurrency": "XOF",
      "rateEffective": "655.2",
      "fiatAmountFinal": "327600",
      "settlementProviderFee": "1500",
      "settlementMnoFee": "500",
      "status": "completed",
      "providerReference": "izipay-5e44…"
    }
  }
}

Rapprocher votre relevé

Trois montants comptent pour votre comptabilité :

fiatAmountFinal — ce qui a été envoyé, au taux rateEffective.
settlementProviderFee et settlementMnoFee — les frais fiat retenus. feeBearer indique qui les porte.
providerReference — la référence à rapprocher du relevé de votre opérateur.

Échecs

Un settlement.failed n’est pas une perte : la crypto reste sur votre solde. Les causes les plus fréquentes sont un compte de retrait inaccessible, un plafond opérateur atteint, ou une indisponibilité temporaire du partenaire. Consultez failureReason, corrigez, puis créez un nouveau reversement — avec une nouvelle idempotencyKey, sans quoi vous récupéreriez l’ancien reversement échoué.

Démarrage

Guides d'intégration

Intégration API

Webhooks

Wallet-as-a-Service

SDKs

Cas d'usage

Se faire reverser en mobile money

1. Vérifier ce qui est reversable

2. Demander un devis

3. Créer le reversement

4. Suivre l’issue

Rapprocher votre relevé

Échecs

Voir aussi

Enregistrer une adresse

Crypto vers fiat

​1. Vérifier ce qui est reversable

​2. Demander un devis

​3. Créer le reversement

​4. Suivre l’issue

​Rapprocher votre relevé

​Échecs

​Voir aussi

Enregistrer une adresse

Crypto vers fiat

1. Vérifier ce qui est reversable

2. Demander un devis

3. Créer le reversement

4. Suivre l’issue

Rapprocher votre relevé

Échecs

Voir aussi