Vue d’ensemble
Intégrez les encaissements, payouts, webhooks et workflows KYC avec Genuka Pay.
Introduction
Genuka Pay est une couche d'infrastructure de paiement pour orchestrer encaissements, décaissements et flux d'activation de conformité sur les marchés africains supportés.
Cette documentation est structurée autour du vrai processus d'intégration :
- connecter votre application
- authentifier les requêtes
- créer un flux de paiement ou payout
- écouter les événements asynchrones via webhooks
- compléter le KYC et déployer en production
Démarrer
Comprenez le flux d'intégration, authentifiez votre application, et lancez votre première requête.
Paiements et Payouts
Explorez l'API pour les encaissements, décaissements, suivi des transactions et callbacks.
Guides opérationnels
Apprenez à gérer vos credentials, configurer le mode test et gérer les préoccupations opérationnelles.
KYC et Lancement
Examinez l'activation et les exigences de conformité avant passer en production.
Nouveau sur Genuka Pay ?
Commencez par le guide Prise en main, puis continuez avec Quick Start et Authentification.
Concepts clés
Paiements : Utilisez Genuka Pay pour initier des encaissements et suivre leur cycle de vie depuis votre backend.
Payouts : Envoyez des fonds aux destinataires via les rails de décaissement supportés avec un flux API unifié.
Webhooks : Recevez les mises à jour asynchrones des changements de statut plutôt que de faire du polling constant.
KYC : Complétez la vérification du compte et les vérifications de conformité avant demander l'accès en production.
Parcours recommandé
Si vous intégrez pour la première fois, suivez cet ordre :
- Lire Vue d'ensemble
- Compléter Quick Start
- Configurer Authentification
- Examiner Vue d'ensemble API
- Configurer Webhooks
- Finaliser Activation du compte et KYC
Plan de la documentation
Prise en main
Vue d'ensemble
Introduction générale au flux d'intégration Genuka Pay.
Quick Start
Lancez votre première intégration avec la configuration minimale requise.
Authentification
Apprenez à authentifier vos requêtes de manière sécurisée avec vos credentials API.
Référence API
Vue d'ensemble API
Comprenez les ressources principales, les patterns de requête et les conventions de réponse.
Paiements
Construisez des flux d'encaissement et suivez l'exécution des paiements.
Payouts
Envoyez des fonds aux destinataires et gérez les opérations de décaissement.
Webhooks
Traitez les événements de livraison et maintenez votre intégration synchronisée.
Guides opérationnels
Méthodes de paiement
Configurez et gérez vos méthodes de paiement mobile money pour recevoir les fonds.
Gérer les clés API
Protégez, renouvelez et séparez vos credentials correctement.
Zones et devises supportées
Examinez les contraintes géographiques et monétaires de votre intégration.
Mode test
Validez vos flux avant d'exposer les vrais montants à vos utilisateurs.
Gestion des erreurs
Concevez des intégrations résilientes qui échouent de manière sûre et transparente.
Bonnes pratiques sécurité
Appliquez les contrôles de sécurité minimums attendus pour une infrastructure de paiement.
Activation du compte et KYC
Comprenez les exigences opérationnelles et de conformité pour l'accès en production.
Avant de passer en production
Utilisez cette checklist avant d'activer le trafic en production :
- votre profil entreprise est complet
- votre soumission KYC a été approuvée
- votre clé secrète est stockée côté serveur uniquement
- votre endpoint webhook est configuré et vérifié
- votre intégration a été testée dans des conditions à faible risque
- votre gestion des erreurs et logique de retry ont été examinées
Conventions utilisées dans cette documentation
{{BASE_URL}}désigne l'URL de base de votre API Genuka Pay- les requêtes authentifiées utilisent les headers HMAC
- les montants doivent toujours être envoyés avec un code ISO de devise explicite comme
XAFouXOF - les mises à jour webhooks doivent être considérées comme la source de vérité pour les changements de statut asynchrones
FAQ
How is this guide?