KKiaPay Sandbox : Guide de Test
Le KKiaPay Sandbox est un environnement de test virtuel autonome qui imite l’environnement de production KKiaPay en direct. Il fournit un espace sécurisé où vous pouvez lancer et regarder votre application traiter les demandes que vous adressez aux API KKiaPay sans toucher à aucun compte KKiaPay actif .
Lorsque vous créez votre compte, KKiaPay vous envoie un courrier électronique de Bienvenue à l'adresse que vous avez spécifié. Le contenu de ce courriel vous instruit sur la démarche à suivre afin de de demander l'activation de votre compte marchand. Si vous ne recevez pas cet e-mail quelques minutes après votre inscription, vérifiez qu'il n'a pas été bloqué ni transféré vers un dossier de courrier indésirable.
Ne laissez s'écouler que quelques secondes entre la création et votre prise en main de l'environnement KKiaPay. En effet, une fois votre compte créé, accédez à la fonctionnalité Sandbox en vous connectant à la plateforme web KKiaPay à l'aide des informations d'identification de votre compte.
Le KKiaPay Sandbox reflète les fonctionnalités présentes sur les serveurs de production KKiaPay. Bien que certaines fonctionnalités de KKiaPay ne s'appliquent pas au sandbox, le sandbox présente une parité avec le jeu de fonctionnalités de l'API de KKiaPay pris en charge par l'environnement en direct. Cela signifie que vous pouvez tester vos processus KKiaPay et savoir qu'ils se comporteront de la même manière sur les serveurs de production que dans l'environnement sandbox.
En utilisant l'environnement de test sandbox fictif et les informations de compte associées dans vos appels d'API KKiaPay, vous pouvez tester et déboguer votre application sans faire référence à aucun utilisateur KKiaPay réel. L'environnement sandbox vous permet d'exploiter votre application dans un environnement sécurisé et vous permet d'ajuster avec précision vos routines KKiaPay avant de mettre votre produit en production.
Lorsque vous lancez une transaction à l'aide d'un compte en sandbox, KKiaPay crée une transaction fictive qui se comporte exactement comme une transaction dans l'environnement en direct. Pendant votre phase de test, utilisez les points de terminaison sandbox et les détails de votre compte de test dans chaque demande d'API KKiaPay que vous effectuez.
Les informations liées à votre compte marchand ne peuvent (et ne doivent) être utilisées en mode test. Nous vous fournissons pour cela cette liste de numéros que vous pourrez utiliser pour effectuer vos tests. La colonne Scénario, vous indique les numéros avec lesquels vous pouvez faire une simulation de transaction réussie ou échouée afin de voir comment votre système réagira pour chacun de ces cas.
Pour simuler tous les scénarios de transactions par mobile money que vous jugerez nécessaires avant de passer en production sur votre compte live nous mettons à votre disposition les numéros ci-après :
Pour l'opérateur GSM MTN
Numéro | Scénario |
61000000 | Successful |
97000000 | Successful |
61000001 | Processing error |
97000001 | Processing error |
61000002 | Insufficient fund |
97000002 | Insufficient fund |
61000003 | Payment declined |
97000003 | Payment declined |
Pour l'opérateur GSM MOOV
Numéro | Scénario |
68000000 | Successful |
95000000 | Successful |
68000001 | Processing error |
95000001 | Processing error |
68000002 | Insufficient fund |
95000002 | Insufficient fund |
68000003 | Payment declined |
95000003 | Payment declined |
Il vous est également offert la possibilité de simuler, en usant des numéros mobile money ci-après, des transactions de type succès avec des temps d'attente allant de 01 à 02 minutes entre l'initialisation de la transaction et sa complétion.
Pour l'opérateur GSM MTN
Numéro | Temps d'attente (En minute) |
61100000 | 01 |
97100000 | 01 |
61200000 | 02 |
97200000 | 02 |
Pour l'opérateur GSM MOOV
Numéro | Temps d'attente (En minute) |
68100000 | 01 |
95100000 | 01 |
68200000 | 02 |
95200000 | 02 |
Afin de faciliter votre compréhension des divers scénarios de transactions par cartes de crédit nous mettons à votre disposition les cartes de crédit tests ci-après :
Pour simuler un cas de succès
Numéro | Date d'expiration | PIN | CVV | OTP | Scénario |
5531 8866 5214 2950 | 09/32 | 3310 | 564 | 12345 | Successful |
4556 0527 0417 2643 | 09/32 | 3310 | 899 | 12345 | Successful |
5438 8980 1456 0229 | 10/31 | 3310 | 564 | 12345 | Successful |
5399 8383 8383 8381 | 10/31 | 3310 | 470 | 12345 | Successful |
4242 4242 4242 4242 | 01/31 | 3310 | 812 | 12345 | Successful |
4751 7632 3669 9647 | 09/35 | ---- | --- | ----- | Successful |
Pour simuler un cas d'échec
Numéro | Date d'expiration | PIN | CVV | OTP | Scénario |
5258 5891 3014 9016 | 11/30 | ---- | 887 | ----- | Payment declined with an |
5590 1317 4329 4314 | 11/32 | 3310 | 887 | 12345 | Payment declined with an |
5258 5859 2266 6506 | 09/31 | 3310 | 883 | 12345 | Payment declined with an |
5143 0105 2233 9965 | 08/32 | 3310 | 276 | ----- | Payment declined with an |
Pendant votre phase de test vous évoluez en usant du serveur de tests KKiaPay qui reçoit et s’occupe du traitement de vos requêtes lorsque que vous êtes en mode test. Evoluez en sandbox, nécessite de vous, de préciser vos clés API test - disponible sur le dashbord.
Lorsque vous passerez en production sur votre compte live, il vous faudra remplacer les clés API test par les clés API de votre compte live. Cela suffira à rendre votre système de paiement opérationnel.
