Environnement Sandbox
L’environnement sandbox vous permet de tester l’ensemble de votre intégration sans déplacer d’argent réel.
Modèle d’environnement
Ikawaari utilise une séparation explicite entre les environnements sandbox et live.
En plus des clés API de test, les outils marchands incluent aussi des comportements sensibles à l’environnement et des opérations de test-mode pour synchroniser et valider la configuration marchande en toute sécurité.
Comment utiliser le Sandbox
- Utilisez des clés API avec le préfixe
ik_test_ - Utilisez la famille de routes implémentée requise par votre intégration
- Aucune transaction réelle n’est traitée
- Les données sont isolées de votre environnement live
Sandbox vs Live
| Fonctionnalité | Sandbox | Live |
|---|---|---|
| Préfixe de clé API | ik_test_ | ik_live_ |
| Argent réel | ❌ Non | ✅ Oui |
| Connexions providers | Simulées | Réelles |
| Webhooks | ✅ Envoyés | ✅ Envoyés |
| Données dashboard | Séparées | Séparées |
Changer d’environnement
Dans le dashboard, utilisez le sélecteur d’environnement dans la barre de navigation supérieure pour basculer entre les vues sandbox et live.
Merchant Test Mode
Ikawaari inclut aussi un comportement de test-mode marchand pour des opérations sandbox contrôlées.
Les actions de test-mode actuelles incluent :
activatedeactivateresync
Ces flux sont importants car une partie de la configuration marchande peut être synchronisée dans le sandbox pour les tests et la validation.
Scénarios sandbox recommandés
- Créer et inspecter un payment intent
- Valider la gestion de la signature webhook
- Simuler les cas de succès, échec et timeout mobile money
- Tester le comportement anti-rejeu avec des clés d’idempotence
- Valider la gestion des payouts et des notifications marchandes
Notes d’implémentation
- Les API checkout et marchandes peuvent utiliser des familles de routes différentes.
- Le changement d’environnement dashboard et le test mode font partie du comportement plateforme implémenté.
- La documentation doit traiter le sandbox comme un modèle d’environnement, et pas seulement comme une liste de faux credentials.
Limitations du Sandbox
- Les invites USSD mobile money sont simulées (aucune notification réelle sur téléphone)
- Les virements bancaires se finalisent instantanément (aucun traitement bancaire réel)
- Les flux carte 3D Secure utilisent des pages de test