Appearance
Test Production
Comment basculer en production sans risque.
Prérequis
- KYC validé niveau 3
- Checklist d'intégration entièrement cochée
- Au moins 48h de tests avec clés
sk_test_…sans erreur applicative
Demande de passage en production
Dashboard Compte Demande de production
Vous fournissez :
- URL du site / app en production
- Volume mensuel attendu (transactions et XOF)
- Catégorie d'activité (e-commerce, marketplace, SaaS, autre)
- Fichier
.haybtech-self-audit.jsonlistant les éléments cochés de la checklist
Réponse sous 24h ouvrées. Possible demande complémentaire de pièces (CGV, mentions légales, RIB).
Bascule technique
Étape 1 Créer les clés pk_live_
Dashboard Développeurs Clés API Nouvelle clé
Sélectionnez Live. La clé est affichée une seule fois, copiez-la dans votre secret manager.
Étape 2 Configurer le webhook live
Dashboard Webhooks Add endpoint
URL = votre endpoint production, qui peut être différent de l'endpoint test. Récupérez le secret immédiatement.
Étape 3 Mettre à jour votre config
Variables d'environnement :
bash
# Avant
HAYBTECH_API_KEY=pk_test_xxxxx
HAYBTECH_WEBHOOK_SECRET=whsec_test_xxxxx
# Après
HAYBTECH_API_KEY=pk_live_xxxxx
HAYBTECH_WEBHOOK_SECRET=whsec_live_xxxxxWARNING
Ne jamais déployer du code qui hardcode une clé. Toujours getenv() ou équivalent.
Étape 4 Vérification
Premier paiement live : envoyez 5 000 XOF à un numéro interne (le vôtre, votre équipe). Vérifiez :
- [ ] La transaction apparaît dans le dashboard avec
livemode: true - [ ] Le webhook arrive sur votre serveur production
- [ ] Le statut bascule en
successaprès confirmation provider - [ ] Votre app marque la commande comme payée
Étape 5 Communication
- Notifier l'équipe support interne : "HayBTech live depuis [date]"
- Mettre à jour votre runbook avec les contacts communiqués à l'onboarding
Coexistence test live
Vous pouvez garder les deux en parallèle :
- Production utilise
pk_live_ - Staging / pré-prod continue avec
pk_test_ - Dev local :
pk_test_aussi
Les deux environnements sont strictement isolés : un objet test n'est pas visible avec une clé live et vice-versa.
Rollback
Si problème en production, retour à pk_test_ en 5 minutes :
- Mettre à jour les variables d'env (sans rebuilder l'image)
- Restart soft du service
- Toutes les transactions futures repartent en mode test (provider simulé, aucun débit)
- Notifier
support@haybtech.com
Les transactions déjà partie en live restent traitées normalement (le rollback n'annule pas l'historique).
Premières heures en prod
- Surveillez les 5 premières transactions une à une
- Surveillez le taux d'erreur sur la première heure
- Surveillez les volumes pendant la première semaine
Toute anomalie : support@haybtech.com avec l'internal_ref et l'horodatage exact.
