2. Créez votre application
Créez et configurez votre première application directement depuis le tableau de bord.
-
Connectez-vous à votre tableau de bord et accédez à la section Applications.
-
Une fenêtre « Votre première application » s'affiche. (Vous pouvez aussi créer des applications plus tard depuis la section Applications.) Dans le formulaire, renseignez les informations générales suivantes :
- Nom de l'application – Le nom public affiché aux clients.
- Email de notification – L'adresse email qui reçoit une confirmation pour chaque paiement.
- Secteur d'activité – Par défaut, celui de votre organisation ; vous pouvez l'ajuster pour cette application.
- Logo de l'application (optionnel) – Téléchargez une image qui apparaîtra dans l'expérience de paiement.
- Environnement :
- Sandbox : Aucune transaction réelle n'est effectuée sur le compte du client.
- Production : Paiement réel ; débit réel sur le compte du client.
Vous pouvez modifier ce réglage plus tard si besoin.
-
Enregistrez l'application. Un nouvel onglet Développeur apparaît. Ouvrez-le pour copier votre clé API. Conservez-la en toute sécurité – ne la partagez jamais et ne l'exposez pas dans le code frontend.
Vous pouvez générer d'autres clés API plus tard depuis les paramètres de l'application.
Dans les paramètres de votre application, ouvrez l'onglet Méthodes de paiement pour activer les fournisseurs que vous souhaitez proposer.
Fournisseurs disponibles :
- MVola
- Orange Money
- Airtel Money
- BRED (Visa)
Pour chaque fournisseur, vous devez choisir comment les fonds sont reçus :
-
Utiliser votre propre compte marchand (
Dans mon compte)
Choisissez cette option si vous avez déjà un contrat direct avec le fournisseur.
Saisissez les identifiants fournis par l'opérateur pour les environnements Sandbox et Production :Fournisseur Identifiants requis MVola Merchant Key, Merchant Phone Number Orange Money Client ID, Password, Merchant Key Airtel Money Client ID, Client Secret BRED Merchant ID, Merchant Key ID, Merchant Secret Key -
Utiliser le compte Papi (
Passer via Papi)
Si vous n'avez pas encore vos propres comptes marchands, Papi agit comme intermédiaire technique et financier. Les paiements sont collectés en votre nom, vous permettant de démarrer rapidement sans attendre l'approbation individuelle de chaque fournisseur.
Activez les fournisseurs dont vous avez besoin et renseignez les informations requises. Enregistrez vos modifications.
- Testez toujours minutieusement en mode Sandbox avant de passer en Production.
- Gardez votre clé API et vos identifiants fournisseurs confidentiels. Ne les intégrez jamais en dur dans un code accessible publiquement.
Un simple numéro de mobile money ou un simple compte bancaire ne suffit pas. Vous devez disposer d'un vrai compte marchand auprès des opérateurs. Demandez-en un auprès de leur équipe opérations ; ils vous fourniront ensuite les identifiants requis.