Guides
Mise en production
La checklist à dérouler avant d’encaisser de vrais paiements.
Compte et affiliations
- L'organisation de production est vérifiée (identité, documents, contrat signé).
- Une affiliation active par prestataire à proposer, avec vos identifiants de production.
- Le compte d'encaissement de production est identifié (Wallet ID de production).
Clés et secrets
- Une clé API de production, distincte de la clé sandbox, rangée dans un coffre ou une variable d'environnement du serveur.
- La clé n'apparaît dans aucun dépôt de code, journal, URL, page web ou application mobile.
- Une procédure pour révoquer et remplacer la clé en cas de fuite.
Intégration
- L'URL d'API pointe vers la production (
https://api.konnect.network), pas la sandbox. - La commande n'est livrée qu'après lecture du paiement :
statusvautcompleted, montant etorderIdidentiques. - Le traitement du webhook est idempotent et répond en moins de 10 secondes.
-
successUrletfailUrlsont en HTTPS et affichent un message clair à l'acheteur. - Les montants sont en millimes (TND) et vérifiés sur une commande à plusieurs articles.
- Les erreurs
4xxet5xxsont journalisées sans la clé API ni les données de carte.
Plugins
- La version installée est la dernière de la page Plugins, sa somme SHA-256 vérifiée.
- Le mode est passé de Sandbox à Production, avec la clé et le Wallet ID de production.
Premier jour
- Un paiement réel de petit montant, de bout en bout, puis son remboursement si besoin.
- Les premiers paiements suivis dans le tableau de bord ; toute anomalie remontée au support Konnect.