Go-live checklist
Avant de basculer en production, parcourez cette liste. Elle reprend les points qui font la différence entre une intégration de test et un encaissement réel fiable.
Kadryza Pay est en preview privée : l’accès production est ouvert progressivement aux marchands intégrés. La vérification KYC de votre compte est un prérequis au passage en live.
Avant de passer en live
Compte marchand vérifié (KYC)
Votre compte doit avoir une vérification KYC validée dans le dashboard. Sans KYC approuvé, l’encaissement réel n’est pas activé.
Intégration validée en sandbox
Testez l’ensemble du parcours avec une clé kadryza_test_… : création de paiement, réception de webhook,
gestion des statuts. Aucune sortie d’argent réelle n’a lieu en test.
Clé live stockée proprement
Générez votre clé kadryza_live_… depuis le dashboard et placez-la dans une variable d’environnement
serveur. Ne la committez jamais. Voir Sécurité.
Webhook de production configuré
- Endpoint HTTPS public, distinct de votre URL de test.
- Vérification de la signature
X-Kadryza-Signatureactive. - Endpoint validé via l’appel de test (
POST /v1/webhooks/:id/test).
Tous les statuts gérés
Votre code doit traiter chaque statut, pas seulement le succès :
| Statut transaction | À gérer |
|---|---|
transaction.success | Valider la commande |
transaction.failed | Informer le client, proposer de réessayer |
transaction.timeout | Considérer le paiement comme non abouti |
Pour les sessions de paiement : payment_session.succeeded, payment_session.expired,
payment_session.under_review.
Erreurs API gérées
Capturez et journalisez les erreurs API (voir Codes d’erreur). Ne supposez jamais qu’un appel
réussit toujours ; prévoyez les cas VALIDATION_ERROR, authentification et indisponibilité réseau.
Montants & paramètres conformes
amount: entier, en XAF (pas de décimales).phone_number: format international+235XXXXXXXX.operator:AIRTELouMOOV.
Idempotence en place
Réutilisez votre reference marchande et dédupliquez les webhooks pour ne jamais encaisser ou valider deux fois.
Observabilité
Journalisez les identifiants de transaction et les événements webhook reçus. Vous en aurez besoin pour le rapprochement et le support.
Le jour du go-live
Une transaction créée avec une clé kadryza_live_… peut déclencher un flux Mobile Money réel.
Faites un premier paiement réel de faible montant pour valider la chaîne complète avant d’ouvrir à vos clients.
- Basculez la variable d’environnement de la clé test vers la clé live.
- Confirmez la réception d’un webhook signé sur l’endpoint de production.
- Surveillez vos premiers paiements depuis le dashboard.
Une question avant d’ouvrir en production ? Écrivez à contact@kadryza.app.