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 sandbox 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 SLE)
• Catégorie d'activité (e-commerce, marketplace, SaaS, autre)
• Fichier .soamtar-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, coordonnées du compte bancaire de règlement).

Bascule technique

Étape 1 : créer les clés sk_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 :

# Avant
SOAMTAR_SECRET_KEY=sk_test_xxxxx
SOAMTAR_WEBHOOK_SECRET=whsec_test_xxxxx

# Après
SOAMTAR_SECRET_KEY=sk_live_xxxxx
SOAMTAR_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 Le 50.00 à un numéro interne (votre numéro Orange Money ou celui de 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 une fois que le client a confirmé avec son code PIN Orange Money
• [ ] Votre app marque la commande comme payée

Étape 5 : communication

• Notifier l'équipe support interne : "SOAMTAR live depuis [date]"
• Mettre à jour votre runbook avec les contacts communiqués à l'onboarding

Coexistence test et live

Vous pouvez garder les deux en parallèle :

• Production utilise sk_live_
• Staging / pré-prod continue avec sk_test_
• Dev local : sk_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 à sk_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 partent en sandbox
4. Notifier support@so-amtar.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@so-amtar.com avec l'internal_ref et l'horodatage exact (heure de Freetown, GMT).