Skip to main content
POST
Initier un transfert interwallet
Le montant reste toujours sur la plateforme — un transfert interwallet ne fait que déplacer des fonds entre deux wallets du même marchand, jamais vers un tiers. Si les devises diffèrent, la conversion utilise le taux de change en vigueur (Lister les taux de change) et des frais peuvent s’appliquer sur le montant converti.

Statut après création

  • PENDING : votre marchand n’a pas l’auto-approbation activée — le transfert attend une validation admin avant que le wallet cible ne soit crédité. Un seul transfert PENDING à la fois est autorisé par marchand.
  • COMPLETED : le transfert a été exécuté immédiatement (auto-approbation activée).

Éviter un doublon en cas de coupure réseau

Le header Idempotency-Key est optionnel : sans lui, un simple retry réseau réserve le montant une seconde fois sur le wallet source. Voir Idempotence.

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

Identifiant unique que vous générez pour cette tentative (un UUID par exemple). Optionnel : sans lui, chaque appel est traité comme une nouvelle demande. Avec lui, si vous renvoyez la même clé — après un timeout ou une coupure réseau — AlphaPay renvoie la réponse d'origine au lieu de créer un second paiement. Réutilisez la même clé pour les retrys d'une même tentative, changez-en pour toute nouvelle intention. La même clé avec un corps de requête différent renvoie une erreur 409. Voir Idempotence.

Maximum string length: 255

Body

application/json
from_country
string
required

Code ISO du wallet source (débité).

Required string length: 2
Example:

"BJ"

to_country
string
required

Code ISO du wallet cible (crédité, après conversion si devise différente).

Required string length: 2
Example:

"CM"

from_amount
string<decimal>
required

Montant réservé sur le wallet source, dans sa devise.

Example:

"50000.00"

merchant
string<uuid>

UUID du marchand visé. Ignoré pour une clé API (toujours vous-même).

Response

Transfert créé — status vaut COMPLETED si WALLET_TRANSFER_AUTO_APPROVE est activé pour votre marchand, PENDING sinon (validation admin requise avant que le wallet cible ne soit crédité).