FAQ et fonctionnalités expliquées

• Mobile money : MTN MoMo, Orange Money, Airtel Money, M-Pesa, Wave, Moov
• Virements bancaires : paiements bancaires directs au Nigeria, au Kenya, en Afrique du Sud
• Cartes : Visa et Mastercard via des partenaires
• Portefeuilles numériques : Opay, PalmPay et autres

1. Créez un compte sandbox sur sandbox-app.payfonte.com
2. Récupérez vos identifiants API dans Settings -> API Keys/Webhooks
3. Configurez votre webhook dans Settings -> API Keys/Webhooks
4. Testez votre intégration en sandbox
5. Terminez le KYB via notre formulaire KYB
6. Passez en production une fois approuvé

• Certificat d’incorporation
• Statuts ou mémorandum
• Résolution du conseil autorisant le traitement des paiements
• Pièce d’identité valide des dirigeants ou UBO
• Justificatif d’adresse
• Relevé bancaire des trois derniers mois

• Certificat d’enregistrement de l’activité
• Pièce d’identité officielle
• Justificatif d’adresse
• Relevé bancaire

​

STK Push

• Le prompt de paiement est envoyé directement sur le téléphone du client
• Le client voit une fenêtre et saisit son PIN
• Pris en charge par M-Pesa et certains marchés MTN
• Expérience fluide mais nécessite un téléphone allumé avec du réseau

​

USSD

• Le client compose un code ou reçoit un menu de session
• Il navigue dans le menu puis saisit son PIN
• Utilisé par MTN MoMo, Orange Money et Airtel Money sur plusieurs marchés
• Compatible avec les téléphones basiques et sans data

​

Autorisation provider

• La demande de paiement est envoyée directement via l’API
• Le MNO invite ensuite le client sur son appareil

• Le client choisit mobile money
• Il saisit son numéro mobile money
• Il clique sur payer

• Le client reçoit un STK push ou un prompt USSD
• Le prompt affiche le marchand, le montant et la référence
• Le client saisit son PIN pour autoriser

• Le client voit un message de paiement réussi sur son téléphone
• Il reçoit la confirmation SMS du MNO
• Il est redirigé vers votre page de succès

1. Le client ouvre l’application ou l’USSD du MNO et génère un code
2. Il partage ce code avec le marchand
3. Le marchand envoie preAuthorisationCode dans la requête API
4. Le paiement est traité sans prompt additionnel

• Orange Burkina Faso
• Orange Sénégal

1. Monitoring temps réel de chaque transaction
2. Polling automatique des API MNO pour les transactions pending
3. Téléchargement et rapprochement des relevés MNO
4. Gestion des timeouts
5. Retry des callbacks webhook jusqu’à accusé de réception

• Afficher des messages d’erreur compréhensibles
• Proposer un retry pour les erreurs relançables
• Journaliser toutes les transactions en échec
• Contacter le support si les erreurs SYSTEM_ERROR persistent

1. Ouvrir Dashboard -> Settings -> API Keys/Webhooks
2. Saisir votre URL webhook, par exemple https://yoursite.com/payfonte/webhook
3. Cliquer sur Save

• Endpoint accessible publiquement, pas en localhost
• HTTPS obligatoire
• Réponse HTTP 200 en moins de 30 secondes
• Traitement idempotent

{
  "event": "payment.completed",
  "timestamp": "2025-02-06T10:30:00Z",
  "data": {
    "reference": "ORDER-12345",
    "checkoutId": "chk_abc123xyz",
    "amount": 5000,
    "currency": "NGN",
    "country": "NG",
    "status": "success",
    "provider": "mtn-momo-nigeria",
    "channel": "mobile-money",
    "user": {
      "email": "customer@example.com",
      "phoneNumber": "08012345678"
    },
    "paidAt": "2025-02-06T10:30:00Z",
    "metadata": {
      "orderId": "your-custom-data"
    }
  }
}

• payment.completed
• payment.failed
• payment.expired
• disbursement.completed
• disbursement.failed

• Tentative 1 : immédiate
• Tentative 2 : 1 minute plus tard
• Tentative 3 : 5 minutes plus tard
• Tentative 4 : 30 minutes plus tard
• Tentative 5 : 1 heure plus tard

• Le statut reste mis à jour dans notre système
• Vous pouvez toujours interroger le statut via l’API
• Vous pouvez rejouer les webhooks depuis le dashboard

• Portefeuilles mobile money
• Comptes bancaires, notamment au Nigeria, au Kenya et dans d’autres marchés
• Flux de décaissement en masse selon la configuration

1. Valider le bénéficiaire
2. Soumettre la demande de décaissement
3. Recevoir le webhook de finalisation

• Mobile money : 30 secondes à 5 minutes
• Virement bancaire : le jour même à J+1 ouvré

• Connectez-vous au dashboard marchand
• Consultez les soldes sur l’écran d’accueil
• Changez de pays via le sélecteur en haut à droite

curl --location 'https://api.payfonte.com/billing/v1/wallets' \
  --header 'client-id: YOUR_CLIENT_ID' \
  --header 'client-secret: YOUR_CLIENT_SECRET'

{
  "data": [
    { "currency": "NGN", "country": "NG", "balance": 1500000 },
    { "currency": "KES", "country": "KE", "balance": 85000 },
    { "currency": "XOF", "country": "CI", "balance": 2500000 }
  ]
}

• Le signe plus
• Les espaces ni les tirets
• Les zéros initiaux après l’indicatif pays

// ✅ Correct
{ "phoneNumber": "2348012345678" }

// ❌ Incorrect
{ "phoneNumber": "+234-801-234-5678" }
{ "phoneNumber": "08012345678" }

• Les paiements serveur à serveur
• Les paiements récurrents
• Les intégrations mobiles natives

curl --location 'https://api.payfonte.com/payments/v1/payments/direct-charge' \
  --header 'client-id: YOUR_CLIENT_ID' \
  --header 'client-secret: YOUR_CLIENT_SECRET' \
  --header 'Content-Type: application/json' \
  --data '{
    "provider": "mtn-momo-nigeria",
    "amount": 5000,
    "reference": "ORDER-12345",
    "customerInput": {
      "phoneNumber": "2348012345678"
    },
    "webhook": "https://yoursite.com/webhook"
  }'

• Vous gardez vos contrats directs avec les MNO
• Vous fournissez vos clés API MNO de manière sécurisée
• Nous routons les transactions via votre compte ou portefeuille provider
• Vous conservez vos tarifs négociés

• Frais plus faibles
• Conservation des relations providers
• Couverture combinée, vos contrats plus nos partenariats
• Dashboard unique pour tous vos APM

1. Si le provider principal échoue, nous essayons les rails de secours
2. L’intégration multi-PSP permet plusieurs providers par pays
3. Le monitoring temps réel détecte les incidents en quelques secondes
4. Le trafic est rerouté sans intervention du marchand

• Principal : intégration directe MTN MoMo
• Secours 1 : MTN via l’agrégateur
• Secours 2 : autre route mobile money disponible

• Conformité PCI DSS
• Scans ASV trimestriels
• Tests d’intrusion annuels
• Chiffrement de bout en bout, en transit et au repos

• Méthodes alignées GDPR
• Minimisation des données collectées
• Chiffrement de toutes les données sensibles
• Contrôles d’accès basés sur les rôles
• Politiques de rétention conformes

• Numéros de téléphone
• Adresses e-mail
• Historique de transaction

• PIN mobile money
• CVV carte
• Soldes de portefeuille client

• Contrôles de vélocité
• Device fingerprinting
• Analyse géographique
• Seuils configurables par marchand
• Gestion de blacklist

• Définir vos propres limites dans le dashboard
• Activer des vérifications supplémentaires pour les gros montants
• Consulter des analyses et rapports de fraude

1. Attendre 5 à 15 minutes
2. Vérifier le statut via l’API
3. Si le blocage dépasse 30 minutes, contacter le support

• Identifiants sandbox utilisés avec l’URL production, ou inversement
• Faute de frappe dans client-id ou client-secret
• Les identifiants ont été régénérés
• Un en-tête requis est manquant

1. Vérifiez l’environnement utilisé
2. Recopiez les identifiants depuis Dashboard -> Settings -> API Keys
3. Vérifiez les noms exacts des en-têtes : client-id et client-secret