Skip to main content
POST
Créer un transfert interwallet
Le header Idempotency-Key est requis — un double-clic/retry réseau sans elle réserverait deux fois le montant sur le wallet source.
Un seul transfert PENDING est autorisé à la fois par marchand. Le wallet source doit ne pas être gelé (le wallet destination, lui, reste toujours créditable même gelé). Selon votre configuration, la réponse peut revenir directement en COMPLETED (auto-approbation activée par un administrateur) ou rester PENDING jusqu’à validation. Erreurs possibles, toutes en 422 : same_country, transfer_already_pending, wallet_frozen, insufficient_balance, no_exchange_rate.

Authorizations

Authorization
string
header
required

Clé API secrète du marchand — header Authorization: Bearer sk_live_xxx (ou sk_test_xxx en environnement de test).

Headers

Idempotency-Key
string<uuid>
required

Valeur unique par tentative logique de transfert.

Body

application/json
from_country
string
required

Code ISO2, ex BJ

to_country
string
required

Code ISO2, ex CM

from_amount
string<decimal>
required

Response

Transfert créé (PENDING ou COMPLETED si auto-approuvé)