KKiaPay Sandbox : Test Guide

Test the features of KKiaPay using the test information available

The KKiaPay Sandbox is an independant virtual test environment that mimics the KKiaPay live production environment. It provides an secure area where you can launch and watch your application process the requests you send to the KKiaPay APIs without touching any active KKiaPay account.

When you create your account, KKiaPay sends you a Welcome on KKiaPay email to the address you specify. The content of this email instructs you on how to request the activation of your merchant account. If you don't receive this email within minutes of registering, check that it hasn't been blocked or forwarded to a spam folder.

It only takes a few seconds to test the KKiaPay environment after creating your account. Once your account has been created, access the Sandbox functionality by connecting to the KKiaPay web platform using your account login access.

Sandbox : Overview

The KKiaPay Sandbox reflects the features found on KKiaPay production servers. Although some KKiaPay features do not apply to the sandbox, it still has parity with the KKiaPay API feature set supported by the live environment. This means that you can test your KKiaPay processes and know then how they will behave on your production servers.

By using the fictitious sandbox test environment and associated account information in your KKiaPay API calls, you can test and debug your application without referring to any real KKiaPay users. The sandbox environment allows you to operate your application in a secure environment and to fine-tune your KKiaPay routines before putting your product into production.

When you start a transaction using a sandbox account, KKiaPay creates a fake transaction that behaves exactly like a transaction in the online environment. During your test phase, use the sandbox endpoints and your account test credentials in each KKiaPay API request you make.

Information related to your merchant account cannot (and should not) be used in test mode. We provide you this list of numbers that you can use to perform your tests. The Scenario column shows you the numbers with which you can simulate a successful or failed transaction to see how your system will react in each of these cases.

Test phone numbers

To simulate all the scenarios of mobile money transactions that you deem necessary before going into production on your live account, we provide you the following numbers:

  • For the GSM operator MTN Benin

  • For the GSM operator MTN Ivory Coast

  • For the GSM operator MOOV

You can also decide to simulate a successful transaction with a wait time between the initialization of the transaction and completion. To do this, KKiaPay provides you with the following phone numbers. The wait time is between 01 and 02 minutes.

  • For the GSM operator MTN

  • For the GSM operator MTN Ivory Coast

  • For the GSM operator MOOV

Test credit cards

In order to help you simulate the various credit card transaction scenarios, we provide you with the following test credit cards:

  • To simulate a successful transaction

  • To simulate a failed transaction

During your test phase you evolve with the KKiaPay test server which receives and handles the processing of your requests when you are in test mode. In sandbox environment, you must use your test api keys which are available on the dashboard.

When you go into production on your live account, you will need to replace the test API keys with the API keys from your live account. This will be enough to make your payment system operational.

Last updated