Mode Sandbox
Testez votre intégration sans risque, sans argent réel.
Sans risque
Aucun paiement réel n'est effectué. Testez en toute sécurité.
Réponses instantanées
Pas d'attente. Les webhooks sont déclenchés immédiatement.
Tests illimités
Testez autant que vous voulez, sans limite ni frais.
Différences Sandbox vs Production
| Fonctionnalité | Sandbox | Production |
|---|---|---|
| Clé API | sk_test_xxx | sk_live_xxx |
| Paiements réels | Non (simulation) | Oui |
| Frais de transaction | Aucun | Selon tarification |
| Webhooks | Instantanés | Temps réel |
| Limites | Illimitées | Selon votre plan |
| KYB requis | Non | Oui |
Configuration
Utilisez votre clé de test pour activer le mode sandbox :
import { Simiz } from '@simiz/node-sdk';
// Mode Sandbox - utilisez votre clé de TEST
const simiz = new Simiz(process.env.SIMIZ_TEST_KEY);
// Clé format: sk_test_xxxxxxxxxxxx
// Mode Production - utilisez votre clé LIVE
const simiz = new Simiz(process.env.SIMIZ_LIVE_KEY);
// Clé format: sk_live_xxxxxxxxxxxxAstuce : Utilisez des variables d'environnement différentes pour chaque environnement. Jamais de clé de production en développement !
Numéros de test
Utilisez ces numéros pour simuler différents scénarios de paiement :
Orange Money
Cameroun| Numéro | Résultat | Description |
|---|---|---|
237690000001 | Succès | Paiement réussi |
237690000002 | Échec | Solde insuffisant |
237690000003 | Timeout | Timeout (pas de réponse) |
237690000004 | Échec | Numéro invalide |
MTN MoMo
Cameroun| Numéro | Résultat | Description |
|---|---|---|
237670000001 | Succès | Paiement réussi |
237670000002 | Échec | Solde insuffisant |
237670000003 | Timeout | Service indisponible |
Wave
Sénégal| Numéro | Résultat | Description |
|---|---|---|
221770000001 | Succès | Paiement réussi |
221770000002 | Échec | Solde insuffisant |
Tester les Webhooks
En mode sandbox, les webhooks sont déclenchés immédiatement après chaque action. Vous pouvez utiliser des outils comme ngrok ou localtunnel pour recevoir les webhooks en développement local.
Avec ngrok
# Terminal 1 - Démarrer votre serveur local
npm run dev # http://localhost:3000
# Terminal 2 - Exposer avec ngrok
ngrok http 3000
# Forwarding: https://abc123.ngrok.io -> http://localhost:3000
# Configurez cette URL comme webhook dans votre dashboard Simiz:
# https://abc123.ngrok.io/api/webhooks/simizDéclencher un webhook manuellement
Depuis le dashboard, vous pouvez aussi déclencher des webhooks de test manuellement pour vérifier votre intégration.
Bonnes pratiques
Testez tous les scénarios
Succès, échecs, timeouts - assurez-vous que votre application gère tous les cas.
Vérifiez les webhooks
Ne vous fiez pas uniquement aux réponses API. Les webhooks sont la source de vérité.
Séparez les environnements
Utilisez des variables d'environnement distinctes pour sandbox et production.
Prêt pour la production ?
Une fois vos tests terminés, complétez la vérification KYB pour passer en production.