Direct Pay vous permet de collecter des paiements directement sur votre plateforme avec l’API Fapshi. Pour l’activer en mode production, vous devez en faire la demande auprès du support Fapshi.
Avant de postuler, vous devez d’abord
Remarque : Direct Pay n’est approuvé que pour des cas d’utilisation absolument nécessaires (par exemple, une application mobile) ou des cas qui ne pourraient pas fonctionner via Initiate Pay. Avant de postuler, assurez-vous donc de remplir ce critère.
Pour demander l’activation de Direct Pay, envoyez un email à support@fapshi.com avec les informations suivantes :
2. Description de votre plateforme
3. Type de plateforme
4. Tests sandbox
5. Raison du choix de Direct Pay
Vous pouvez commencer à collecter des dons sur votre site WordPress en quelques minutes avec les liens de paiement Fapshi — aucun plugin ni codage requis.
C’est idéal pour les projets personnels, les ONG, les églises, les associations étudiantes, ou toute personne souhaitant recevoir du soutien financier.
💡 Ce dont vous avez besoin
Option 1 : Ajouter un bouton
Dans l’éditeur WordPress, ajoutez un bloc bouton
Option 2 : Lien texte
Par exemple :
Pour soutenir notre mission, cliquez ici pour faire un don.
(Remplacez par votre lien réel)
Option 3 : Widget ou barre latérale
Utilisez les widgets WordPress pour placer le lien dans le pied de page ou la colonne latérale.
L'API Fapshi propose deux méthodes puissantes pour collecter les paiements : Direct Pay et Initiate Pay. Chacune répond à des cas d'utilisation distincts, équilibrant contrôle, facilité d'intégration et expérience utilisateur. Cet article détaille les différences, les avantages et les scénarios idéaux pour utiliser Direct Pay et Initiate Pay, vous aidant à choisir la meilleure approche pour votre application. Que vous souhaitiez créer un flux de paiement personnalisé ou que vous ayez besoin d'une solution rapide, l'API de Fapshi vous couvre. Pour plus de détails, consultez la documentation officielle de l'API Fapshi.
Direct Pay permet aux développeurs de lancer des paiements directement depuis le portefeuille mobile d'un utilisateur sans le rediriger vers une page externe. Avec cette méthode, vous avez un contrôle total sur le formulaire de paiement et l'expérience utilisateur, créant un processus de paiement fluide au sein de votre application. Cependant, cela implique la responsabilité de gérer les validations, les saisies utilisateur et le flux de paiement de votre côté. Le backend de Fapshi traite la transaction, garantissant sécurité et fiabilité, tandis que vous gérez l'expérience front-end.
apiuser et apikey pour l'authentification.Si vous avez oublié votre code PIN ou pensez qu’il a été compromis, vous pouvez faire une demande de réinitialisation sécurisée via notre support.
Étape 1 : Allez sur la page de support Fapshi
Étape 2 : Choisissez l’objet du message : "Changer mon code PIN"
Étape 3 : Dans le message, indiquez :
Comment obtenir votre code de support ?
Cliquez sur l’icône de profil (en haut à droite du tableau de bord), puis copiez le code support affiché.
Une fois votre demande approuvée, suivez les mêmes étapes décrites dans Comment créer votre PIN pour en définir un nouveau.
Allez dans Paramètres → Code PIN oublié ?
Suivez les instructions pour soumettre une demande de réinitialisation.
Ne communiquez jamais votre code PIN à personne.
Même l’équipe Fapshi ne vous le demandera jamais.
Toute personne ayant votre code PIN peut accéder à votre solde.
Fapshi vous permet de transférer de l’argent de votre compte vers d’autres utilisateurs Fapshi rapidement et en toute sécurité.
Remarque : Le montant minimum que vous pouvez transférer est de 500 FCFA.
Étape 1 : Connectez-vous à votre tableau de bord
Allez dans Plus → Paiements → Transferts dans le menu de gauche.
Étape 2 : Cliquez sur “Effectuer un transfert”
Cliquez sur le bouton en haut à droite de la page des transferts.
Étape 3 : Renseignez les informations demandées :
Vous avez besoin d’un PIN pour effectuer un transfert Fapshi.
• Voir comment définir votre PIN
• Vous avez oublié votre PIN ? Voici quoi faire
Si vous souhaitez envoyer de l’argent à quelqu’un qui n’a pas de compte Fapshi (ex : utilisateurs Mobile Money), faites un retrait (payout).
Étape 4 : Confirmez le transfert
Une fois soumis, vous verrez la transaction :
Fapshi applique un frais de 0.5% pour les transferts.
Utilisez notre calculatrice de frais pour estimer le coût selon le montant que vous souhaitez envoyer.
Le code PIN Fapshi est un code à 5 chiffres utilisé pour valider toute sortie d’argent de votre compte, comme :
Vous devez créer un code PIN avant d’utiliser ces fonctionnalités.
Étape 1 : Connectez-vous à votre tableau de bord Fapshi
Étape 2 : Cliquez sur Créer en haut à droite, puis sélectionnez :
« Un PIN (transferts et paiements) »
Étape 3 : Saisissez votre code PIN à 5 chiffres et cliquez sur Valider
Étape 1 : Ouvrez l’application mobile Fapshi
Étape 2 : Accédez à Paramètres → Sécurité → Créer un PIN
Étape 3 : Saisissez et confirmez votre code PIN à 5 chiffres
Ne communiquez jamais votre code PIN à qui que ce soit, même à un membre de l’équipe Fapshi.
Toute personne ayant accès à votre code pourrait vider votre compte.
Fapshi ne vous demandera jamais votre code PIN.
Si vous oubliez votre code PIN, consultez le Guide de réinitialisation du PIN pour le modifier.
6. Fournissez UNIQUEMENT le Live API user de votre service de collecte. NE PARTAGEZ JAMAIS VOTRE Live API key !
7. Fournissez le lien vers votre site web en ligne.
✅ Une fois votre demande examinée et approuvée, le support Fapshi activera Direct Pay pour votre compte en mode production, vous permettant ainsi de traiter de vrais paiements.
Si vous avez une boutique WooCommerce ou souhaitez vendre des produits sur votre site WordPress, utilisez notre plugin WordPress pour collecter les paiements.
Contactez support@fapshi.com
transId (ID de transaction) avec un code de statut 200 pour les demandes réussies ou un code 4XX avec un message d'erreur pour les échecs.transId pour vérifier le statut de la transaction (SUCCESSFUL ou FAILED) via l'API ou recevoir des mises à jour via un webhook configuré.Remarque : Les transactions Direct Pay n'expirent pas, et leur état final est soit SUCCESSFUL soit FAILED. Assurez-vous de gérer les identifiants de manière sécurisée, car une mauvaise utilisation peut entraîner une suspension de compte conformément aux Conditions générales de Fapshi.
Initiate Pay simplifie le processus de paiement en fournissant une page de paiement préconstruite, hébergée par Fapshi. Les utilisateurs sont redirigés vers cette page pour finaliser leur paiement, et Fapshi gère l'ensemble du flux de paiement, y compris les validations et les invites utilisateur. Cette méthode est idéale pour les développeurs qui souhaitent une intégration rapide et à faible effort sans construire une interface de paiement personnalisée.
transId.Remarque : Comme pour Direct Pay, les transactions Initiate Pay sont traitées de manière sécurisée, et vous devez protéger vos identifiants API pour éviter toute mauvaise utilisation.
Les deux méthodes exploitent le backend robuste de Fapshi pour un traitement sécurisé des paiements, mais elles diffèrent en termes de contrôle, de complexité et d'effort d'intégration. Voici une comparaison détaillée :
| Fonctionnalité | Initiate Pay | Direct Pay |
|---|---|---|
| Expérience de paiement | Page de paiement hébergée par Fapshi | Personnalisée, dans l'application/site |
| Effort d'intégration | Faible (utilisation d'un lien préconstruit) | Élevé (création et gestion du formulaire) |
| Flux utilisateur | Redirection vers la page de Fapshi | Pas de redirection, fluide dans l'app |
| Personnalisation | Limité à la conception de Fapshi | Contrôle total sur l'UI/UX |
| Responsabilité | Fapshi gère validations et flux | Développeur gère validations et flux |
| Temps de configuration | Rapide (peu de codage requis) | Plus long (développement personnalisé) |
| Statut de transaction | SUCCESSFUL, FAILED, PENDING, EXPIRED via webhook/API | SUCCESSFUL ou FAILED, via API |
Le choix entre Direct Pay et Initiate Pay dépend des besoins de votre application, des ressources de développement et de l'expérience utilisateur souhaitée. Le tableau ci-dessous présente les meilleurs scénarios pour chaque méthode :
| Scénario | Meilleure méthode | Pourquoi |
|---|---|---|
| E-commerce avec paiement de marque | Direct Pay | Intègre les paiements de manière fluide dans votre site ou app, en correspondant à votre marque. |
| Achats in-app | Direct Pay | Garde les utilisateurs dans l'application, améliorant l'UX et réduisant les abandons. |
| Flux de paiement complexes | Direct Pay | Permet des validations et une logique personnalisées pour des besoins spécifiques. |
| Mise en place rapide pour startups | Initiate Pay | Nécessite un minimum de développement, idéal pour un déploiement rapide. |
| Projets à faible budget | Initiate Pay | Réduit les coûts de développement en utilisant la page de paiement de Fapshi. |
| Campagnes de paiement temporaires | Initiate Pay | Facile à configurer des liens de paiement pour des campagnes ponctuelles. |
| Volume élevé, faible personnalisation | Initiate Pay | Efficace pour les entreprises privilégiant la rapidité à la conception personnalisée. |
Avantages :
Inconvénients :
Avantages :
Inconvénients :
Pour implémenter l'une ou l'autre méthode, commencez par consulter la section Connaissances préliminaires dans la documentation de l'API Fapshi. Assurez-vous d'avoir votre apiuser et apikey prêts pour l'authentification, et testez dans l'environnement sandbox avant de passer en production. Pour Direct Pay, concentrez-vous sur la création d'un formulaire de paiement sécurisé et convivial ; pour Initiate Pay, générez et testez des liens de paiement. En cas de problème, contactez support@fapshi.com ou rejoignez la communauté de développeurs Fapshi sur Slack pour obtenir de l'aide.
Direct Pay et Initiate Pay répondent à différents besoins dans le spectre de l'intégration des paiements. Direct Pay est idéal pour les développeurs qui privilégient une expérience de paiement sur mesure dans l'application et disposent des ressources pour créer et gérer un flux de paiement personnalisé. Initiate Pay est parfait pour ceux qui recherchent une solution rapide et à faible effort avec une page de paiement préconstruite. En comprenant les besoins de votre entreprise — comme la personnalisation, le temps de développement et l'expérience utilisateur — vous pouvez choisir la méthode qui correspond le mieux à vos objectifs. Explorez la documentation de l'API Fapshi pour aller plus loin et commencer l'intégration dès aujourd'hui.