Skip to content

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.json listant 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_xxxxx

WARNING

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 success aprè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 :

  1. Mettre à jour les variables d'env (sans rebuilder l'image)
  2. Restart soft du service
  3. Toutes les transactions futures repartent en mode test (provider simulé, aucun débit)
  4. 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.

Documentation de l'API de paiement HayBTech.