Bienvenue
Intégrez Koory Core
en 5 minutes
Votre guide étape par étape pour connecter votre application aux APIs de paiement, wallet et transactions Koory Core.
Votre parcours d'intégration
Créez votre compte développeur
Inscrivez-vous sur Koory Core pour obtenir un tenant dédié et accéder à toutes les APIs.
S'inscrireGénérez vos clés API
Depuis votre dashboard, créez une paire API Key / API Secret pour authentifier vos requêtes serveur-à-serveur.
API KeysTéléchargez un SDK
Choisissez le SDK adapté à votre stack (Node.js, Python, PHP, Go, TypeScript) et intégrez-le en quelques minutes.
Télécharger SDKTestez dans le sandbox
Utilisez l'environnement sandbox pour simuler des transactions, créer des utilisateurs fictifs et valider votre intégration sans risque.
Accéder au sandboxPassez en production
Une fois vos tests validés, basculez en production et commencez à traiter de vraies transactions.
ParamètresCode Quickstart
// 1. Installer les dépendances
npm install axios
// 2. Copier le SDK dans votre projet
// Téléchargement : /sdk/koory-core.js
// 3. Initialiser le client
const { KooryCore } = require('./koory-core')
const client = new KooryCore({
baseUrl: 'https://koory-core-backend.onrender.com/api',
apiKey: process.env.KOORY_API_KEY,
apiSecret: process.env.KOORY_API_SECRET,
environment: 'sandbox'
})
// 4. Premier appel API
const balance = await client.getBalance('SANDBOX_USER_ID')
console.log('Solde sandbox :', balance)
// 5. Simuler un dépôt
const tx = await client.transfer({
userId: 'SANDBOX_USER_ID',
amount: 5000,
method: 'mobile_money',
direction: 'DEPOSIT'
})
console.log('Transaction :', tx.id, tx.status)Questions fréquentes
Qu'est-ce qu'un tenant ?
Un tenant est votre espace isolé dans Koory Core. Il contient vos utilisateurs, transactions, webhooks et paramètres. Chaque développeur possède un tenant unique, complètement séparé des autres.
Quelle est la différence entre sandbox et production ?
Le sandbox utilise des données fictives et simule les transactions sans mouvement d'argent réel. La production traite de vraies transactions financières. Vous pouvez basculer entre les deux à tout moment.
Comment fonctionne la signature HMAC ?
Chaque requête est signée avec HMAC-SHA256 en utilisant votre API Secret. Le message signé est composé de l'environnement (sandbox/production) suivi du body JSON. Cela garantit l'intégrité et l'authenticité de chaque appel.
Puis-je utiliser Koory Core sans SDK ?
Oui, toutes les APIs sont accessibles via HTTP REST standard. Les SDK facilitent l'intégration en gérant automatiquement la signature HMAC, les retries, et la sérialisation. Consultez la documentation pour les appels directs.
Comment tester mes webhooks en local ?
Utilisez un outil comme ngrok pour exposer votre serveur local, puis enregistrez l'URL publique dans la section Webhooks. Le dashboard permet aussi d'envoyer des webhooks de test manuellement.
Prêt à démarrer ?
Créez votre compte développeur gratuitement et commencez à intégrer les APIs Koory Core en quelques minutes.