API

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.

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.

Prérequis

Avant de postuler, vous devez d’abord implémenter Direct Pay en mode sandbox sur votre plateforme et vous assurer qu’il fonctionne correctement. Cela est nécessaire pour démontrer votre intégration avant l’activation en mode production.

Comment postuler

Pour demander l’activation de Direct Pay, envoyez un email à support@fapshi.com avec les informations suivantes :

1. Vos informations personnelles et professionnelles
   • Votre nom complet
   • L’adresse email de votre compte Fapshi
   • Le nom de votre entreprise (tel qu’enregistré sur Fapshi)

2. Description de votre plateforme

• Expliquez clairement comment fonctionne votre plateforme (ou comment elle fonctionnera une fois lancée).

3. Type de plateforme

• Indiquez s’il s’agit d’une application web ou d’une application mobile.

4. Tests sandbox

• Confirmez si vous avez déjà implémenté votre solution en utilisant l’environnement sandbox.

5. Raison du choix de Direct Pay

• Expliquez pourquoi vous préférez Direct Pay au lieu de Initiate Pay. Consultez cet article pour connaître la différence entre Direct Pay et Initiate Pay :
  Direct Pay vs Initiate Pay : tout ce que vous devez savoir

6. Fournissez UNIQUEMENT le Live API user de votre service de collecte. NE PARTAGEZ JAMAIS VOTRE Live API key !

Notes importantes

• Assurez-vous de répondre à toutes les questions dans votre email. Cela accélérera l’examen et le traitement de votre demande.
• Si des informations sont manquantes, le support pourra demander des précisions supplémentaires, ce qui peut retarder votre activation.

✅ 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.

Here’s the French translation of your text:

Pour obtenir vos identifiants de production (apiuser, apikey), vous devez créer un service dans votre tableau de bord Fapshi. Voici comment procéder :

1. Connectez-vous à votre tableau de bord Fapshi.
2. Dans le menu latéral, allez dans le menu déroulant Merchants.
3. Cliquez sur « Nouveau Service ».
4. Remplissez les informations requises :
   • Nom du service (par exemple, le nom de votre application ou site web)
   • Nom de domaine (le domaine que vous possédez ou que vous souhaitez utiliser) — vous pouvez utiliser un domaine que vous ne possédez pas encore, mais évitez d’utiliser le domaine de Fapshi (ex. ne pas utiliser fapshi.com).
5. Une fois le service créé, en bas de la page du tableau de bord/service, vos identifiants apiuser et apikey pour ce service seront affichés. Copiez-les soigneusement. Ils sont sensibles, surtout le apikey.
6. Sauvegardez vos identifiants de manière sécurisée (par ex. dans un fichier d’environnement ou un coffre-fort sécurisé). Ne les intégrez pas en dur dans le code et ne les publiez pas dans des dépôts publics. Renouvelez les clés si nécessaire.

⚠️ Note : En mode Live, la fonction de paiement/distribution peut être désactivée par défaut. Vous devrez peut-être contacter le support Fapshi pour l’activer une fois que vous aurez testé le sandbox et serez prêt à passer en production.

Lorsque vous êtes prêt à passer en production — c’est-à-dire commencer à traiter de vrais paiements via Fapshi au lieu de simples tests — vous devez apporter quelques modifications. Voici les étapes :

Une fois ces changements effectués, votre intégration fonctionnera en mode production — transactions réelles, argent réel, etc.