Enregistrer une adresse de reversement

Un compte de retrait (settlement account) est la destination fiat de vos reversements : un numéro mobile money ou un wallet. Il faut en déclarer au moins un avant de pouvoir se faire reverser. Scope requis : settlements:write (settlements:read pour la lecture)

1. Lister les moyens de règlement disponibles

Un compte de retrait est toujours rattaché à un moyen de règlement (opérateur + pays + devise). Récupérez d’abord la liste :

curl https://api.izichangepay.com/v1/settlement-accounts/payment-methods \
  -H "Authorization: Bearer $IZIPAY_API_KEY"

Chaque entrée porte son id, son displayName, son country, sa currency, son accountType (momo ou wallet) et surtout addressFormatExample — le format attendu pour receptionAddress.

Ne codez pas en dur la liste des opérateurs. Elle évolue (nouveaux pays, nouveaux partenaires) et un moyen de règlement peut être désactivé. Lisez-la à l’exécution.

2. Créer le compte

curl -X POST https://api.izichangepay.com/v1/settlement-accounts \
  -H "Authorization: Bearer $IZIPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "settlementPaymentMethodId": "3f9a1c2e-6b4d-4a1e-9c8f-2b7d5e0a1f34",
    "receptionAddress": "22961234567",
    "label": "MoMo principal",
    "isDefault": true
  }'

Champ	Requis	Sens
`settlementPaymentMethodId`	✅	L’`id` obtenu à l’étape 1.
`receptionAddress`	✅	Le numéro ou identifiant du compte. Validé contre le format du moyen de règlement.
`label`		Libellé libre pour vous repérer.
`isDefault`		Marque ce compte comme destination par défaut. Le précédent défaut est automatiquement déclassé.

receptionAddress est validé par une expression de format propre à chaque opérateur. Un numéro correct pour un opérateur sera rejeté pour un autre. En cas de 400, comparez avec addressFormatExample du moyen de règlement choisi.

3. Lister vos comptes

curl https://api.izichangepay.com/v1/settlement-accounts \
  -H "Authorization: Bearer $IZIPAY_API_KEY"

Conservez l’id retourné : c’est le settlementAccountId à fournir lors d’un reversement.

Modification et suppression

Créer un compte de retrait est possible par API. Le modifier ou le supprimer ne l’est pas — ces actions sont réservées au tableau de bord.

C’est un choix de sécurité. Une clé API compromise peut, au pire, ajouter une destination — un acte traçable, visible dans votre tableau de bord et révocable. Elle ne peut ni détourner une destination existante en la réécrivant, ni effacer l’historique. Pour corriger une adresse erronée : créez un nouveau compte et marquez-le isDefault, ou passez par le tableau de bord.

Voir aussi

Se faire reverser

Utiliser ce compte pour recevoir vos fonds.

Reverser automatiquement

Déclencher le reversement dès qu’un paiement est complété.

Adresses de retrait

Les protections autour des destinations.

Démarrage

Guides d'intégration

Intégration API

Webhooks

Wallet-as-a-Service

SDKs

Cas d'usage

Enregistrer une adresse de reversement

1. Lister les moyens de règlement disponibles

2. Créer le compte

3. Lister vos comptes

Modification et suppression

Voir aussi

Se faire reverser

Reverser automatiquement

Adresses de retrait

​1. Lister les moyens de règlement disponibles

​2. Créer le compte

​3. Lister vos comptes

​Modification et suppression

​Voir aussi

Se faire reverser

Reverser automatiquement

Adresses de retrait

1. Lister les moyens de règlement disponibles

2. Créer le compte

3. Lister vos comptes

Modification et suppression

Voir aussi