Wallets & Conversion
Les comptes professionnels multi-devises (wallet_mode=multiwallet) détiennent un solde par devise simultanément, gérés depuis le portail Business dédié du tableau de bord.
Comptes multi-devises
Un compte professionnel peut être configuré en mode multiwallet. À la création, un wallet à solde 0 est pré-provisionné pour chaque devise active — pas de provisioning paresseux. Un compte standard (uniwallet) garde un seul solde directement sur le compte, exactement comme avant ; c'est un type de compte optionnel, pas un changement cassant pour les comptes existants.
Frais payin, payout et conversion
Les frais de collecte (payin) et de décaissement (payout) sont configurés indépendamment pour un même corridor pays. Pour les comptes multiwallet spécifiquement, les retraits portent aussi des frais (les comptes standards n'ont jamais de frais de retrait). Convertir entre deux wallets d'un même compte applique ses propres frais, configurés par paire de devises — voir la page Tarifs pour les règles et formules exactes.
Authentification
Les endpoints ci-dessous utilisent votre session dashboard (utilisateur connecté), pas les clés API publiques pk_/sk_ utilisées ailleurs dans cette documentation — ils ne sont pas accessibles avec des headers de clé publique/secrète.
Endpoints du dashboard
/accounts/{account_id}/walletsRetourne une entrée par wallet de devise active pour le compte.
Response Body
La devise du wallet (code, symbole, taux de change).
Solde total détenu dans ce wallet.
Solde disponible pour un retrait.
Montant cumulé déjà retiré de ce wallet.
/accounts/{account_id}/wallets/convertConvertit des fonds d'un wallet vers un autre wallet du même compte. Refusé si aucune règle de frais de conversion n'est configurée pour la paire de devises — il n'y a pas de conversion gratuite implicite.
Request Body
L'identifiant de la devise du wallet à débiter.
L'identifiant de la devise du wallet à créditer.
Le montant à convertir, dans la devise source.
Response Body
Montant débité du wallet source.
Frais de conversion déduits avant le change.
Montant crédité sur le wallet destination.
Taux de change appliqué pour cette conversion.
/accounts/{account_id}/wallets/conversionsHistorique paginé des conversions du compte.
Fonctionnalité réservée au dashboard
L'API publique n'expose pas les wallets : consulter les soldes par devise ou convertir des fonds entre wallets n'est possible que via le portail Business du dashboard. Côté crédit, /collections et le checkout hébergé créditent le wallet de la devise réglée par le client ; /payouts débite toujours le wallet de la devise principale du compte.