Méthodes de paiement
Enregistrez les numéros mobile money vers lesquels vos payouts peuvent être envoyés.
Une méthode de paiement est un numéro mobile money enregistré par votre entreprise. Elle sert de destinataire de payout : au lieu de décrire le bénéficiaire à chaque requête, vous passez son payment_method_id à POST /api/v1/payouts.
Gestion depuis le dashboard uniquement
Les méthodes se créent, se modifient et se suppriment depuis la page Méthodes de paiement du dashboard. Les endpoints /api/v1/payment-methods qu’elle utilise n’acceptent que la session du dashboard : ils ne peuvent pas être appelés avec vos clés API.
Ce que vous pouvez faire
- ajouter un numéro mobile money
- modifier le titulaire, activer ou désactiver une méthode
- marquer une méthode comme principale
- supprimer une méthode
Champs
| Champ | Description |
|---|---|
identifier | Numéro mobile money au format international, ex. +237677001122 |
account_holder_name | Nom du titulaire (150 caractères max) |
is_primary | Méthode principale de l’entreprise |
is_active | Méthode utilisable ou non |
metadata | Données libres |
Vous ne choisissez pas l’opérateur : il est déduit du numéro, dans le pays de votre entreprise, et le numéro est vérifié à l’enregistrement. La méthode renvoie ensuite l’opérateur retenu (operator_provider) et son statut de vérification (verification_status).
Utilisation dans un payout
{
"amount": 25000,
"currency": "XAF",
"payment_method_id": "01k7c4t9m2y8x5b3n6q0r1s2t3"
}Le payment_method_id doit appartenir à votre entreprise ; sinon la requête est rejetée en 422. Il n’y a pas de méthode utilisée par défaut : sans payment_method_id, envoyez recipient_phone et operator_code. Voir API Payouts.
Bonnes pratiques
- Test - Testez chaque méthode avec un petit montant avant un usage intensif
- Surveillance - Désactivez une méthode dont le numéro n’est plus valide plutôt que de la laisser échouer
- Sécurité - Restreignez l’accès au dashboard aux personnes habilitées à modifier les destinataires
How is this guide?
Last updated on