Comptes et alias
Consulter vos comptes
Utilisez GET /comptes pour lister vos comptes et GET /comptes/{numero} pour consulter un compte. Le scope requis est compte.read. Les champs et les réponses sont détaillés dans la référence API.
Les comptes accessibles sont ceux autorisés pour votre client business. Les informations de compte et les soldes proviennent du système bancaire du participant.
Déplacer des fonds entre vos comptes
Le contrat expose POST /comptes/transactions pour créer un mouvement et GET /comptes/transactions pour consulter les mouvements. Utilisez les scopes compte_transaction.write et compte_transaction.read respectivement.
Si une opération demeure à l’état INITIE, consultez son résultat avec le filtre txId au lieu de créer un nouveau mouvement. Le guide BCEAO décrit IRREVOCABLE et REJETE comme résultats finaux de ce parcours.
Gérer vos alias
| Action | Méthode et chemin | Scope |
|---|---|---|
| Créer un alias | POST /comptes/{numero}/alias | alias.write |
| Lister les alias d’un compte | GET /comptes/{numero}/alias | alias.read |
| Supprimer un alias | DELETE /comptes/{numero}/alias/{cle} | alias.delete |
| Vérifier un enrôlement | GET /alias/{cle} | enrolement_alias.read |
Le guide Business présente les alias SHID et MCOD. Le MCOD s’utilise lorsque le service USSD est disponible. La suppression d’un alias est définitive : les paiements adressés à cet alias supprimé sont rejetés.
Consultez les schémas et exemples dans la référence avant de construire vos corps de requête. Votre participant précise les types et capacités activés pour votre business.