Go-live checklist

Compte vérifié et live activé

• E-mail vérifié et profil marchand complet.
• Dossier KYC soumis et validé par Kadryza.
• Mode live activé pour votre compte par Kadryza. Sans cela, toute création live répond 403 LIVE_MODE_NOT_ALLOWED.

Intégration validée en test

Avec une clé kadryza_test_… : création d’une Payment Session (ou d’un Hosted Checkout), affichage du paiement, réception et vérification d’un webhook, gestion de chaque statut.

Chemin de paiement cible

Votre intégration crée des Payment Sessions ou des Hosted Checkouts. POST /v1/transactions et les liens de paiement ne fonctionnent pas en live (503 LEGACY_LIVE_TRANSACTION_DISABLED).

Téléphone du payeur

En live, customer_phone est obligatoire à la création d’une Payment Session (400 CUSTOMER_PHONE_REQUIRED sinon). Le Hosted Checkout le demande au client si vous ne le fournissez pas.

Clé live stockée côté serveur

Générez la clé depuis le dashboard (un second facteur récent vous sera demandé) et placez-la dans un secret serveur. Jamais dans le navigateur ni dans un dépôt. Voir Sécurité.

Webhook de production

• URL HTTPS publique.
• Signature X-Kadryza-Signature vérifiée sur le corps brut.
• Déduplication sur event_id.
• Connectivité vérifiée avec POST /v1/webhooks/:id/test.

Tous les statuts gérés

Une session live n’est jamais EXPIRED : sans preuve de paiement à l’échéance, elle passe en UNDER_REVIEW.

Erreurs gérées

Traitez au minimum PROVIDER_RAIL_NOT_READY, NO_COLLECTION_NUMBER_AVAILABLE (opérateur momentanément indisponible), DUPLICATE_REFERENCE (relire par référence) et les erreurs réseau (relire par référence avant de recréer). Voir Codes d’erreur.

Idempotence

Une commande = une reference = une session. Ne créez pas de seconde session pour une commande tant que la première n’est pas conclue.

Journalisation

Conservez l’id, la reference, le ticket et les event_id reçus : ils servent au rapprochement et au support.