Recevez votre premier paiement en 5 minutes
Suivez ce guide étape par étape pour intégrer Simiz dans votre application.
Créer un compte
Inscrivez-vous gratuitement et accédez à votre dashboard.
Obtenir vos clés API
Récupérez vos clés de test depuis le dashboard.
Intégrer le SDK
Installez notre SDK ou utilisez l'API REST directement.
Tester en sandbox
Effectuez votre premier paiement de test.
Créer votre compte Simiz
Commencez par créer un compte gratuit. Aucune carte bancaire n'est requise pour commencer.
Obtenir vos clés API
Une fois connecté, rendez-vous dans Paramètres → Clés API pour récupérer vos clés.
Clé de test (Sandbox)
sk_test_xxxxxxxxxxxxUtilisez cette clé pour les tests. Aucun paiement réel ne sera effectué.
Clé de production (Live)
sk_live_xxxxxxxxxxxxUtilisez cette clé pour les paiements réels après validation KYB.
Important: Ne partagez jamais vos clés secrètes. Gardez-les côté serveur uniquement.
Intégrer le SDK
Installation
npm install @simiz/node-sdkConfiguration
import { Simiz } from '@simiz/node-sdk';
// Initialize with your test key
const simiz = new Simiz(process.env.SIMIZ_SECRET_KEY);Créer votre premier paiement
// Créer une transaction Mobile Money
const transaction = await simiz.transactions.create({
amount: 5000, // 5000 XAF
currency: 'XAF',
payment_method: 'ORANGE_MONEY',
payer: {
phone: '237690000000', // Numéro du client
name: 'John Doe',
},
description: 'Commande #12345',
callback_url: 'https://votre-site.com/webhooks/simiz',
return_url: 'https://votre-site.com/success',
});
console.log(transaction.id); // tx_xxx
console.log(transaction.status); // PENDING
console.log(transaction.payment_url); // URL pour le clientTester en mode Sandbox
Utilisez ces numéros de test pour simuler différents scénarios de paiement :
| Numéro de test | Opérateur | Résultat |
|---|---|---|
237690000001 | Orange Money | Succès |
237670000001 | MTN MoMo | Succès |
237690000002 | Orange Money | Échec - Solde insuffisant |
237690000003 | Orange Money | Timeout |
Félicitations !
Vous avez intégré Simiz avec succès. Voici les prochaines étapes :