Vue d'ensemble

Payfonte propose plusieurs méthodes pour collecter les paiements de vos clients à travers l’Afrique via notre API d’orchestration de paiement. Acceptez les principaux moyens de paiement alternatifs (APM) et moyens de paiement locaux en Afrique via une seule intégration.

Méthodes d’intégration

Checkout inline

Intégré à votre pageAffichez un formulaire de paiement directement sur votre site sans rediriger le client. Idéal pour une expérience fluide.

Checkout standard

Redirection vers PayfonteRedirigez le client vers une page de paiement hébergée par Payfonte. C’est l’intégration la plus simple avec une prise en charge complète des moyens de paiement.

Direct Charge

Serveur à serveurInitiez les débits directement via l’API pour les paiements récurrents ou lorsque vous avez déjà collecté les informations de paiement.

Liens de paiement

Option sans codeGénérez des URL de paiement partageables depuis le dashboard. Pratique pour les factures, les réseaux sociaux et les campagnes e-mail.

Comparaison rapide

Méthode	Effort d’intégration	Expérience client	Cas d’usage
Standard	Faible	Redirection vers une page hébergée	La plupart des marchands
Inline	Moyen	Intégré à votre site	UX fluide
Direct Charge	Élevé	Pas d’interface, côté serveur	Récurrent, cartes enregistrées
Liens de paiement	Aucun	Paiement via lien	Factures, paiements ponctuels

Vue d’ensemble du flux de paiement

Moyens de paiement alternatifs pris en charge

Région	Mobile Money API	Virement bancaire	Cartes
Nigeria	MTN MoMo API, Airtel, Opay, PalmPay	✅ Oui	Via partenaire
Ghana	MTN MoMo API, AirtelTigo, Telecel	Bientôt disponible	Via partenaire
Kenya	M-Pesa API	✅ Oui	Via partenaire
Tanzanie	M-Pesa API, Airtel Money API, Halopesa, Tigo	Bientôt disponible	-
Afrique de l’Ouest (CFA)	Orange Money, MTN, intégration Wave, Moov	-	-

Voir Providers pris en charge pour la liste complète des moyens de paiement locaux en Afrique.

Requête de collecte minimale

Voici un exemple minimal pour créer une session de checkout :

curl --location 'https://sandbox-api.payfonte.com/payments/v1/checkouts' \
  --header 'client-id: YOUR_CLIENT_ID' \
  --header 'client-secret: YOUR_CLIENT_SECRET' \
  --header 'Content-Type: application/json' \
  --data '{
    "reference": "ORDER-001",
    "amount": 5000,
    "currency": "NGN",
    "country": "NG",
    "redirectURL": "https://yoursite.com/payment/complete",
    "webhook": "https://yoursite.com/webhooks/payfonte",
    "user": {
      "email": "customer@example.com",
      "phoneNumber": "08012345678"
    }
  }'

Paramètres requis

Paramètre	Type	Description
`reference`	string	Votre identifiant de commande ou de transaction unique
`amount`	integer	Montant en sous-unités, voir Spécification des montants
`currency`	string	Code devise ISO, par exemple NGN, KES, GHS, XOF
`country`	string	Code pays ISO, par exemple NG, KE, GH
`redirectURL`	string	URL vers laquelle rediriger le client après paiement

Paramètres optionnels

Paramètre	Type	Description
`webhook`	string	URL pour les notifications de paiement
`user.email`	string	Adresse e-mail du client
`user.phoneNumber`	string	Numéro de téléphone du client
`metadata`	object	Données personnalisées à attacher à la transaction

Valeurs de statut

Les statuts de collecte renvoyés par l’API sont :

pending
failed - final
success - final

Traitement des webhooks

Nous envoyons des notifications webhook lors des changements de statut de paiement. En production, implémentez toujours leur traitement :

app.post('/webhooks/payfonte', (req, res) => {
  const event = req.body;

  switch (event.event) {
    case 'payment.completed':
      // Paiement réussi : exécuter la commande
      fulfillOrder(event.data.reference);
      break;
    case 'payment.failed':
      // Paiement échoué : informer le client
      notifyCustomer(event.data.reference);
      break;
  }

  res.status(200).send('OK');
});

Voir Webhooks pour la documentation complète.

Bonnes pratiques

Toujours utiliser des références uniques

Générez une valeur reference unique pour chaque transaction. Cela évite les doubles débits et simplifie le rapprochement.

Implémenter l'idempotence

Votre système doit gérer les retries de webhook sans effet de bord. Vérifiez si une commande est déjà traitée avant de la rejouer.

Vérifier le statut de transaction

Après réception d’un webhook, vérifiez le statut de la transaction via l’API avant d’exécuter la commande.

Gérer les délais d'attente correctement

Certains moyens de paiement, comme l’USSD, prennent du temps. Affichez au client un état d’attente adapté.

Étapes suivantes

Checkout inline

Intégrer les paiements à votre site

Checkout standard

Intégration par redirection

Configuration webhook

Traiter les notifications de paiement

Référence API

Documentation API complète

Premiers pas

Concepts clés

Prestataires et couverture

Développement

Encaisser des paiements

Décaissements

Méthodes d’intégration

Checkout inline

Checkout standard

Direct Charge

Liens de paiement

Comparaison rapide

Vue d’ensemble du flux de paiement

Moyens de paiement alternatifs pris en charge

Requête de collecte minimale

Paramètres requis

Paramètres optionnels

Valeurs de statut

Traitement des webhooks

Bonnes pratiques

Étapes suivantes

Checkout inline

Checkout standard

Configuration webhook

Référence API

​Méthodes d’intégration

Checkout inline

Checkout standard

Direct Charge

Liens de paiement

​Comparaison rapide

​Vue d’ensemble du flux de paiement

​Moyens de paiement alternatifs pris en charge

​Requête de collecte minimale

​Paramètres requis

​Paramètres optionnels

​Valeurs de statut

​Traitement des webhooks

​Bonnes pratiques

​Étapes suivantes

Checkout inline

Checkout standard

Configuration webhook

Référence API

Méthodes d’intégration

Comparaison rapide

Vue d’ensemble du flux de paiement

Moyens de paiement alternatifs pris en charge

Requête de collecte minimale

Paramètres requis

Paramètres optionnels

Valeurs de statut

Traitement des webhooks

Bonnes pratiques

Étapes suivantes