Paiements

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.

Étapes

É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 :

• Email du destinataire (doit être lié à un compte Fapshi)
• Montant
• Motif du transfert
• Votre code PIN

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 :

• Sur votre page Transferts
• Réflétée dans votre solde de compte

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.

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.

Comprendre Direct Pay

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.

Caractéristiques clés de Direct Pay

• Personnalisation complète : Concevez le formulaire de paiement pour qu'il corresponde à votre marque et à votre interface utilisateur.
• Aucune redirection : Les utilisateurs restent dans votre application ou site web, offrant une expérience fluide.
• Responsabilité du développeur : Vous gérez la validation des entrées, la gestion des erreurs et la vérification du statut des transactions.
• Flexibilité des cas d'utilisation : Idéal pour les applications nécessitant des flux de paiement sur mesure, comme les achats in-app ou les systèmes de paiement intégrés.

Comment ça fonctionne

1. Votre application collecte les détails du paiement (par exemple, numéro de téléphone, montant) via un formulaire personnalisé.
2. L'application envoie une demande de paiement à l'API de Fapshi en utilisant votre apiuser et apikey pour l'authentification.
3. Fapshi traite la demande et invite l'utilisateur à confirmer la transaction sur son portefeuille mobile.
4. Une fois terminée, vous recevez un 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.
5. Vous pouvez utiliser le 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.

Comprendre Initiate Pay

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.

Caractéristiques clés d'Initiate Pay

• Paiement préconstruit : Fapshi fournit une page de paiement prête à l'emploi, réduisant le temps de développement.
• Intégration simplifiée : Peu de codage requis — générez simplement un lien de paiement et redirigez les utilisateurs.
• Fapshi gère le flux : La plateforme gère les validations, les invites utilisateur et le traitement des transactions.
• Moins de contrôle : Vous dépendez de la conception de la page de paiement de Fapshi, ce qui peut limiter la personnalisation.

Comment ça fonctionne

1. Votre application envoie une demande de paiement à l'API de Fapshi avec des détails comme le montant et le numéro de téléphone de l'utilisateur.
2. Fapshi génère un lien de paiement unique et le renvoie dans la réponse de l'API.
3. Vous redirigez l'utilisateur vers la page de paiement hébergée par Fapshi.
4. L'utilisateur finalise le paiement sur son portefeuille mobile via la page hébergée.
5. Fapshi vous notifie du statut de la transaction (SUCCESSFUL ou FAILED) via un webhook (si configuré) ou par une vérification de statut à l'aide du 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.

Comparaison entre Direct Pay et Initiate Pay

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 :

Meilleurs cas d'utilisation : Quand utiliser Direct Pay vs. Initiate Pay

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 :

Avantages et inconvénients

Direct Pay

Avantages :

• Expérience utilisateur fluide sans redirections.
• Contrôle total sur le formulaire de paiement et la marque.
• Flexible pour les flux de paiement complexes ou uniques.

Inconvénients :

• Nécessite plus d'efforts de développement pour créer et maintenir le formulaire de paiement.
• Les développeurs sont responsables de la validation des entrées et de la gestion des erreurs.
• Risque plus élevé d'erreurs si mal implémenté.

Initiate Pay

Avantages :

• Rapide et facile à intégrer avec un minimum de codage.
• Fapshi gère l'ensemble du flux de paiement, réduisant la charge de travail des développeurs.
• Idéal pour le prototypage rapide ou les projets à petite échelle.

Inconvénients :

• Personnalisation limitée, car la page de paiement suit la conception de Fapshi.
• Les redirections peuvent perturber l'expérience utilisateur ou augmenter les taux d'abandon.
• Moins adapté aux applications nécessitant un processus de paiement entièrement intégré.

Premiers pas

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.

Conclusion

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.