Guides
Tester avec la sandbox
Un environnement complet avec des affiliations fictives et des cartes de test, pour tout essayer sans argent réel.
La sandbox reproduit la production avec des prestataires de test : aucun paiement n'y est réel, aucune carte n'y est débitée.
Environnements
| Environnement | API v2 | Usage |
|---|---|---|
| Sandbox | https://api.preprod.konnect.network | Intégration, tests, démonstrations. |
| Production | https://api.konnect.network | Paiements réels, après la checklist de mise en production. |
Chaque environnement a ses propres comptes, organisations, clés API et Wallet ID. Une clé sandbox est refusée en production (401), et inversement : c'est la première chose à vérifier devant un 401.
Ouvrir un compte sandbox
- Inscrivez-vous sur le tableau de bord sandbox et créez une organisation.
- Ajoutez une affiliation de test pour chaque prestataire à essayer : les identifiants de test sont préremplis, aucun contrat n'est nécessaire.
- Générez une clé API et notez le Wallet ID.
Cartes de test
Les cartes de test dépendent du prestataire de test (ClicToPay, Flouci, IZI...). Elles sont affichées sur la page de paiement sandbox et seront listées ici avec les identifiants sandbox des prestataires (lot 1.5) ; aucune ne fonctionne en production.
Jamais de vraie carte en sandbox
N'utilisez jamais une vraie carte ni de vraies données client en sandbox, même pour un essai rapide. Les noms, e-mails et numéros des exemples sont fictifs.
Scénarios à couvrir avant la production
- Paiement réussi : la commande passe à payée une seule fois, même si le webhook arrive deux fois.
- Paiement refusé : l'acheteur revient sur
failUrlet peut réessayer. - Paiement expiré : rien n'est livré au-delà de
lifespan. - Montant modifié : un écart entre le paiement et la commande bloque la livraison.
- Clé invalide : votre site affiche une erreur claire, sans exposer la clé.