💸Initialiser un transfert
Utilisation de l'API de Transfert Moneroo
Avec l'API de transfert Moneroo, vous pouvez envoyer de l'argent à vos clients. Cette API est utile pour les remboursements, les remises, les paiements de salaires, etc.
Fonctionnement
Depuis votre serveur, envoyez une requête POST à l'API de transfert Moneroo avec les détails du transfert.
Moneroo traite la demande via la passerelle de paiement appropriée en fonction de la méthode de transfert définie.
Moneroo vous envoie une réponse indiquant l'état du transfert.
Étape 1 : Collecte des données du transfert
Tout d'abord, vous devez collecter les détails du transfert qui seront envoyés à notre API sous la forme d'un objet JSON.
Voici les champs à collecter :
Nom du champ | Type | Obligatoire | Description |
---|---|---|---|
| integer | Oui | Le montant du transfert. |
| string | Oui | La devise du transfert. La devise doit être une devise prise en charge dans un format ISO 4217 valide. |
| string | Oui | Description du transfert. |
| string | Oui | Méthode de transfert. Il doit s'agir d'une méthode de transfert valide et prise en charge. Veuillez consulter la liste des méthodes de transfert prises en charge. |
| object | Oui | Détails sur les clients. |
| string | Oui | Adresse e-mail du client. |
| string | Oui | Prénom du client. |
| string | Oui | Nom du client. |
| integer | Non | Numéro de téléphone du client dans le format E164. |
| string | Non | Adresse du client. |
| string | Non | Ville du client. |
| string | Non | État du client. |
| string | Non | Pays du client. Il s'agir du code du pays au format ISO 3166-1 alpha-2 valide. |
| string | Non | Code postal du client. |
| array | Non | Données supplémentaires pour le transfert. |
Étape 2 : Ajouter des champs obligatoires pour des méthodes de transfert spécifiques
Chaque méthode de paiement a ses propres champs obligatoires. Veuillez consulter la liste des méthodes de transfert prises en charge pour connaître les champs requis pour chaque méthode de paiement.
Par exemple, pour la méthode mtn_bj
(MTN Mobile Money Bénin) , vous devez ajouter les champs suivants :
msisdn
: Le numéro de téléphone MTN Mobile Money Benin du client où l'argent sera envoyé.
Étape 3 : Envoi de la demande de transfert
Ensuite, lancez le transfert en appelant notre API avec les détails du transfert collectés (n'oubliez pas d'autoriser la requête avec votre clé secrète).
Exemple de demande :
Exemple de réponse :
Étape 4 : Après l'envoi de la demande de transfert
D'accord, voici le texte révisé :
Une fois le transfert effectué (avec ou sans succès), trois choses se produisent :
Nous vous enverrons un Webhook si vous l'avez activé. Pour plus d'informations sur les Webhooks et pour voir des exemples, consultez notre guide sur les Webhooks.
Nous vous enverrons un email (sauf si vous l'avez désactivé).
Côté serveur, vous pouvez vérifier la transaction en appelant notre API avec l'ID de la transaction.
Si vous avez activé les Webhooks, nous vous enverrons une notification pour chaque transfert échoué. C'est utile si vous souhaitez contacter les clients ultérieurement ou effectuer d'autres actions. Consultez notre guide sur les Webhooks pour un exemple.
Exemple
N'oubliez pas de remplacer
YOUR_SECRET_KEY
par votre véritable clé secrète.Tous les exemples suivants doivent être réalisés dans le backend, ne jamais exposer votre clé secrète au public.
cURL
Last updated