L’intégration de FedaPay dans une application (web, mobile ou logiciel métier) se fait en quelques étapes simples. Le processus est le même peu importe la technologie que vous utilisez : PHP, Node.js, Java et Ruby.

Étapes d’intégration

1. Créer un compte FedaPay

• Ouvrez un compte FedaPay.

• Accédez à votre tableau de bord.

• Passez d’abord par la Sandbox, l’environnement de test où vous pouvez simuler tous les paiements sans risques.

2. Récupérer vos clés API

Vous trouverez vos clés dans : Tableau de bord → API

Vous aurez deux jeux de clés :

• Sandbox

• Production

Et pour chaque environnement :

• Clé publique (Public Key) → Utilisée côté client (front-end)

• Clé secrète (Secret Key) → Utilisée côté serveur (back-end)

⚠️ Ne jamais utiliser une clé secrète dans le code public.

3. Installer le SDK ou utiliser directement l’API

FedaPay met à disposition plusieurs SDKs pour simplifier l’intégration dans votre application, quel que soit votre langage ou framework. Vous pouvez soit installer l’un des SDKs disponible.

SDKs Backend disponibles

Ces SDKs facilitent la création de transactions, la gestion des paiements, des clients et l’accès aux fonctionnalités avancées.

• PHP

• Node.js

• Ruby

Chaque SDK permet de :

• créer des transactions,

• vérifier les statuts,

• gérer les clients,

• effectuer des paiements Mobile Money ou carte,

• intégrer les webhooks.

SDKs Frontend disponibles

Ces SDKs sont destinés aux applications web modernes et facilitent l’intégration du paiement côté client.

• React

• Angular

Ils permettent notamment :

• d’ouvrir l’interface de paiement FedaPay,

• de gérer les redirections et événements,

• d’intégrer une expérience front-end fluide.

Accéder aux SDKs

Vous pouvez consulter tous les SDKs officiels, leur documentation et leurs guides d’installation ici :Lien vers les SDKs FedaPay

4. Créer une transaction via l’API

Depuis votre serveur, vous créez une session de paiement avec :

• le montant,

• la devise,

• la description,

• les informations du client.

Cette étape génère une transaction FedaPay.

5. Rediriger le client vers la page de paiement

Deux possibilités :

Option A : Redirection vers la Page de Paiement FedaPay

L’utilisateur est redirigé vers une page sécurisée où il choisit :

• carte bancaire (Visa, Mastercard),

• Mobile Money (MTN, Moov),

• ou tout autre moyen activé.

Option B : Exécuter un paiement Mobile Money directement

Vous pouvez déclencher le paiement via l’API (débit automatique du numéro saisi).

Environnement de test (Sandbox)

En Sandbox, vous pouvez simuler tous les paiements avec :

Mobile Money

Utilisez le mode spécial momo_test pour simuler :

• paiements validés,

• paiements échoués,

• différentes réponses opérateurs.

⚠️ Les transactions Sandbox ne sont jamais envoyées en production.

Que pouvez-vous faire avec l’API FedaPay ?

Via l’API, vous pouvez gérer l’ensemble des fonctionnalités de FedaPay :

• Clients

• Transactions

• Paiements Mobile Money

• Paiements par carte

• Payouts (si votre compte est autorisé)

• Balances

• Webhooks

• Logs

• Événements

• Devises

• Paiements récurrents (si activés)

Documentation technique complète

Pour les détails techniques, exemples de code et endpoints :Lien vers l’API Reference FedaPay