Paiements

Qu’est-ce que le code PIN Fapshi ?

Le code PIN Fapshi est un code à 5 chiffres utilisé pour valider toute sortie d’argent de votre compte, comme :

• Les transferts vers d’autres utilisateurs Fapshi
• Les paiements vers des comptes Mobile Money ou bancaires

Vous devez créer un code PIN avant d’utiliser ces fonctionnalités.

💻 Créer votre PIN depuis le tableau de bord

É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

📱 Créer votre PIN via l’application mobile

É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 partagez jamais votre code PIN !

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.

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.