Ce guide couvre l’utilisation de l’environnement sandbox et les étapes pour passer en production.
Environnements
CaurisFlux propose deux environnements isolés :
| Environnement | URL de base | Préfixe clés | Usage |
|---|
| Sandbox | https://sandbox-api.caurisflux.com/api/v1 | pk_test_ / sk_test_ | Développement et tests |
| Production | https://prod-api.caurisflux.com/api/v1 | pk_live_ / sk_live_ | Transactions réelles |
Différences entre sandbox et production
| Aspect | Sandbox | Production |
|---|
| Mouvements de fonds | Simulés | Réels |
| Numéros de téléphone | Numéros de test uniquement | Numéros réels |
| Webhooks | Fonctionnels | Fonctionnels |
| Dashboard | Données de test | Données réelles |
| KYC requis | Non | Oui |
Environnement Sandbox
L’environnement sandbox permet de tester votre intégration sans effectuer de transactions réelles.
Numéros de test Mobile Money
Utilisez ces numéros pour simuler différents scénarios :
Paiements réussis
| Numéro | Provider | Comportement |
|---|
+221770000001 | Wave | Succès immédiat |
+221770000002 | Orange Money | Succès après 5 secondes |
+221770000003 | MTN | Succès après 10 secondes |
+221770000004 | Free Money | Succès immédiat |
Paiements échoués
| Numéro | Erreur simulée |
|---|
+221770000010 | insufficient_balance - Solde insuffisant |
+221770000011 | transaction_declined - Transaction refusée |
+221770000012 | invalid_phone - Numéro non enregistré |
+221770000013 | provider_timeout - Timeout provider |
+221770000014 | daily_limit_exceeded - Limite journalière |
Comportements spéciaux
| Numéro | Comportement |
|---|
+221770000020 | Reste en pending indéfiniment |
+221770000021 | pending → success après 30 secondes |
+221770000022 | pending → failed après 30 secondes |
Cartes de test
| Numéro | Résultat |
|---|
4111 1111 1111 1111 | Paiement réussi |
4000 0000 0000 0002 | Carte déclinée |
4000 0000 0000 0069 | Carte expirée |
4000 0000 0000 3220 | Authentification 3DS requise |
Pour les cartes de test, utilisez n’importe quelle date d’expiration future et n’importe quel CVV à 3 chiffres.
Tester les webhooks
Via le Dashboard
- Allez dans Paramètres > Webhooks
- Sélectionnez votre endpoint
- Cliquez sur Envoyer un test
- Choisissez l’événement à simuler
Via l’API
Vérifier votre environnement
Passage en production
Prérequis
Avant de pouvoir effectuer des transactions réelles :
Compléter la vérification KYC
Soumettez vos documents d’entreprise dans Dashboard > Paramètres > Vérification
Attendre la validation
L’équipe CaurisFlux vérifie vos documents (généralement sous 24-48h)
Obtenir les clés production
Une fois validé, vos clés sk_live_* sont activées
Checklist avant mise en production
Vérifiez ces points avant de basculer en production :
Configuration
Webhooks
Sécurité
Gestion des erreurs
Tests
Basculer en production
Mettre à jour les variables d'environnement
Déployer
Déployez votre application avec les nouvelles variables
Tester avec un petit montant
Effectuez une transaction réelle avec le montant minimum (100 XOF)
Vérifier le webhook
Confirmez que le webhook de la transaction test a été reçu
Erreurs courantes en production
1. Utiliser les clés de test
401 Unauthorized - Invalid API key
sk_live_* et non sk_test_*.
2. Endpoint webhook non accessible
Les webhooks échouent si votre serveur :
- N’est pas accessible depuis Internet
- N’utilise pas HTTPS
- Répond trop lentement
3. Certificat SSL invalide
Assurez-vous que votre certificat SSL est valide et non auto-signé.
4. Numéros de test en production
Les numéros de test (+221770000001, etc.) ne fonctionnent qu’en sandbox.
Monitoring en production
Logs recommandés
Métriques à surveiller
| Métrique | Seuil d’alerte |
|---|
| Taux de succès des paiements | < 90% |
| Temps de réponse API | > 2 secondes |
| Webhooks non livrés | > 1% |
| Erreurs 5xx | > 0.1% |
Alertes recommandées
- Pic d’erreurs
PROVIDER_ERROR
- Échecs de signature webhook répétés
- Transactions bloquées en
pending > 30 minutes
Support
En cas de problème en production :
Incluez dans votre demande :
- Le
transaction_id
- L’heure de l’incident
- Les logs pertinents (sans données sensibles)
