Reverser automatiquement chaque paiement

Le reversement automatique (auto-settlement) déclenche un reversement seul, dès qu’un payment intent passe à completed — sans que vous ayez à appeler POST /settlements vous-même. Il se configure via le champ autoSettlement, disponible sur tous les modes de création de paiement.

Où l’activer

Mode	Où	Portée	Vérification
Paiement avec redirection	`POST /v1/payment-intents`	Ce paiement	À la création (erreur `400`)
Charge directe	`POST /v1/payment-intents/direct`	Ce paiement	À la création, avant l’allocation de l’adresse
Facture	`POST /v1/invoices`, `PATCH /v1/invoices/{id}`	Le paiement de la facture	À l’enregistrement de la facture
Produit	`POST /v1/products`, `PATCH /v1/products/{id}`	Chaque paiement du lien produit	À l’enregistrement du produit
Caisse (POS)	Tableau de bord, réglages du terminal	Chaque encaissement de la caisse	À la configuration du terminal

Les champs et les erreurs sont les mêmes partout. Dans le tableau de bord, l’option Reversement automatique figure aussi dans les formulaires de lien de paiement, de facture et de produit. Scope requis : payment_intents:write (ou invoices:write / products:write pour les factures et les produits)

1. Activer avec le compte de règlement par défaut

Le plus simple : n’indiquez qu’enabled. Le compte de règlement marqué isDefault chez vous est utilisé.

curl -X POST https://api.izichangepay.com/v1/payment-intents \
  -H "Authorization: Bearer $IZIPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requestedCurrencyType": "fiat",
    "currencyRequested": "XOF",
    "amountRequested": "25000",
    "autoSettlement": { "enabled": true }
  }'

Champ (`autoSettlement.`)	Requis	Sens
`enabled`	✅	Active le reversement automatique pour ce paiement.
`settlementAccountAddress`		Adresse cible (numéro mobile money, IBAN…). Omise : le compte par défaut est utilisé.
`settlementPaymentMethodId`		Moyen de règlement (`GET /settlement-accounts/payment-methods`). Voir §2.

Sans compte de règlement par défaut configuré, la création échoue immédiatement avec AUTO_SETTLEMENT_NO_DEFAULT_ACCOUNT — pas au moment du paiement. Déclarez-en un avant d’activer l’option.

2. Cibler une adresse précise

Fournissez settlementAccountAddress pour reverser ailleurs que sur le compte par défaut. Par défaut, cette adresse doit correspondre à un compte de règlement déjà enregistré chez vous, et mature (même délai de sécurité que les adresses de confiance — 24h par défaut).

curl -X POST https://api.izichangepay.com/v1/payment-intents \
  -H "Authorization: Bearer $IZIPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requestedCurrencyType": "fiat",
    "currencyRequested": "XOF",
    "amountRequested": "25000",
    "autoSettlement": {
      "enabled": true,
      "settlementAccountAddress": "+22501020304"
    }
  }'

Adresse non enregistrée

Si votre compte a activé « autoriser le reversement vers des adresses non whitelistées » (dans vos paramètres), vous pouvez cibler une adresse qui n’est pas encore déclarée — mais vous devez alors préciser aussi settlementPaymentMethodId, puisqu’il n’existe aucun compte existant pour en déduire le rail (opérateur/pays/devise) :

{
  "autoSettlement": {
    "enabled": true,
    "settlementAccountAddress": "+22501020304",
    "settlementPaymentMethodId": "3f9a1c2e-6b4d-4a1e-9c8f-2b7d5e0a1f34"
  }
}

Erreurs possibles

Tout est validé à la création du paiement, pas après — vous découvrez un problème de configuration immédiatement, jamais après que le client a payé.

Code (`400`)	Cause
`AUTO_SETTLEMENT_NO_DEFAULT_ACCOUNT`	Aucune adresse fournie et aucun compte par défaut configuré.
`AUTO_SETTLEMENT_DEFAULT_NOT_MATURED`	Le compte par défaut existe mais n’est pas encore mature.
`AUTO_SETTLEMENT_ADDRESS_NOT_REGISTERED`	Adresse fournie inconnue, et le toggle « adresses non whitelistées » est désactivé.
`AUTO_SETTLEMENT_ADDRESS_NOT_MATURED`	Adresse fournie connue, mais pas encore mature (toggle désactivé).
`AUTO_SETTLEMENT_PAYMENT_METHOD_REQUIRED`	Adresse non enregistrée + toggle activé, mais `settlementPaymentMethodId` manquant.
`AUTO_SETTLEMENT_NO_SETTLEABLE_ASSET`	Aucune des cryptos proposées au client n’est reversable — aucun partenaire disponible pour votre pays/devise.
`AUTO_SETTLEMENT_ASSET_NOT_SUPPORTED`	Une crypto que vous avez nommée (`acceptedCoins`, `requestedCoin`, `assetCode`) n’est pas reversable vers ce moyen de règlement. Le message liste celles qui le sont.
`AUTO_SETTLEMENT_RAIL_NOT_SUPPORTED`	Le moyen de règlement de la destination n’est desservi par aucun partenaire.
`AUTO_SETTLEMENT_BELOW_RAIL_MINIMUM`	Montant fiat sous le minimum de reversement de ce moyen de règlement.

Quand vous ne nommez aucune crypto, la liste proposée au client est restreinte à celles qui sont reversables, au lieu d’échouer. Quand vous en nommez, une crypto non reversable est refusée : la retirer sans rien dire vous laisserait croire qu’elle est proposée.

3. Charge directe

La charge directe renvoie l’adresse de dépôt en un seul appel. Elle accepte autoSettlement avec les mêmes règles. Une erreur est renvoyée avant qu’une adresse soit allouée. Le montant peut être libellé en crypto (par défaut) ou en fiat :

curl -X POST https://api.izichangepay.com/v1/payment-intents/direct \
  -H "Authorization: Bearer $IZIPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requestedCoin": "USDT.TRC20",
    "amount": "25000",
    "requestedCurrencyType": "fiat",
    "currencyRequested": "XOF",
    "customer": { "firstName": "Awa", "lastName": "Diallo", "email": "awa@example.com" },
    "autoSettlement": { "enabled": true }
  }'

Avec requestedCurrencyType: "fiat", le montant est converti en requestedCoin au cours du moment. La réponse renvoie le montant crypto à envoyer (amountToSend), verrouillé jusqu’à l’expiration.

4. Factures et produits

Sur une facture ou un produit, autoSettlement est enregistré avec l’objet, puis appliqué au paiement que le client effectue.

curl -X POST https://api.izichangepay.com/v1/products \
  -H "Authorization: Bearer $IZIPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Abonnement Pro",
    "amount": "30000",
    "currency": "XOF",
    "permanentLinkSlug": "abonnement-pro",
    "autoSettlement": { "enabled": true, "settlementAccountAddress": "+22501020304" }
  }'

À l’enregistrement, la destination est vérifiée comme sur un paiement, avec les mêmes erreurs. Vous corrigez avant d’envoyer la facture ou de diffuser le lien.
Au paiement, la demande est figée sur le payment intent créé pour le client. Si la destination est devenue inutilisable entre-temps (compte révoqué, moyen de règlement plus desservi…), le client paie quand même : le paiement est encaissé sans reversement, et les fonds restent sur votre solde.
Pour désactiver, envoyez "autoSettlement": null dans le PATCH.

La réponse renvoie autoSettlement tel qu’enregistré, ou null s’il n’est pas activé.

5. Suivre le déclenchement

La réponse à la création confirme l’activation :

{ "id": "…", "status": "waiting_address_selection", "autoSettlement": { "enabled": true } }

Le reversement lui-même ne se déclenche qu’après le paiement (payment_intent.completed) — pas au moment de la création. Récupérez-le via linkedSettlement sur le payment intent :

curl https://api.izichangepay.com/v1/payment-intents/{id} \
  -H "Authorization: Bearer $IZIPAY_API_KEY"

{
  "id": "…",
  "status": "completed",
  "autoSettlement": { "enabled": true },
  "linkedSettlement": {
    "id": "5e44…",
    "status": "pending",
    "fiatAmountIndicative": "24350",
    "fiatAmountFinal": null,
    "fiatCurrency": "XOF",
    "createdAt": "2026-08-31T10:02:14.000Z",
    "failureReason": null
  }
}

linkedSettlement est null un court instant après le paiement (le déclenchement est asynchrone), puis reflète l’état du reversement exactement comme un settlement créé manuellement — mêmes événements webhook (settlement.completed, settlement.failed…) à écouter pour le résultat définitif.

Si le déclenchement lui-même échoue (adresse révoquée entre-temps, plus aucun partenaire disponible…), rien n’est perdu : les fonds restent sur votre solde marchand normal, disponibles pour un reversement manuel. C’est purement informatif — aucune action requise de votre part.

Voir aussi

Se faire reverser

Le fonctionnement d’un reversement, déclenché manuellement ou automatiquement.

Enregistrer une adresse

Déclarer le compte qui recevra vos reversements.

Adresses de confiance

Le délai de sécurité qui s’applique aussi aux adresses de reversement.

Reversements (tableau de bord)

Où voir vos reversements automatiques dans l’interface.

Démarrage

Guides d'intégration

Intégration API

Webhooks

Wallet-as-a-Service

SDKs

Cas d'usage

Reverser automatiquement chaque paiement

Où l’activer

1. Activer avec le compte de règlement par défaut

2. Cibler une adresse précise

Adresse non enregistrée

Erreurs possibles

3. Charge directe

4. Factures et produits

5. Suivre le déclenchement

Voir aussi

Se faire reverser

Enregistrer une adresse

Adresses de confiance

Reversements (tableau de bord)

​Où l’activer

​1. Activer avec le compte de règlement par défaut

​2. Cibler une adresse précise

​Adresse non enregistrée

​Erreurs possibles

​3. Charge directe

​4. Factures et produits

​5. Suivre le déclenchement

​Voir aussi

Se faire reverser

Enregistrer une adresse

Adresses de confiance

Reversements (tableau de bord)

Où l’activer

1. Activer avec le compte de règlement par défaut

2. Cibler une adresse précise

Adresse non enregistrée

Erreurs possibles

3. Charge directe

4. Factures et produits

5. Suivre le déclenchement

Voir aussi