All Collections
Visual Guides
Testing DirectPay in Sandbox mode
Testing DirectPay in Sandbox mode

See how your customers interact with DirectPay

Omolara Akanni avatar
Written by Omolara Akanni
Updated over a week ago

Before you get started, check out these articles on how to create an app and how to switch app between live and sandbox mode.

Once you've confirmed that your app is set to test mode on the dashboard, you can follow these steps:

  1. First, you pass the body params and test secret key required on the "Initiate a Payment" endpoint in your API platform, as seen in the screenshot below.

2. In the response, a payment link will be generated. Then, you pass this payment link into your browser to start the test payment process. This will take you to the DirectPay widget in test mode. Click the "Pay with Mono" button to get started.

3. Next, select the bank of your choice from the list of banks displayed.

4. You will be provided with two options of 'Success' and 'Failed' so you can see the response and behaviour of both a successful payment and a failed payment respectively.

5. a) For the successful payment test experience: Click on 'Success' and select the account you wish to continue with (in this case, a user has multiple accounts in one bank). Then, click on 'Continue'.

a) You'll see a screen showing you the payment details as inputted in the body params initially. The payment details include the amount, app name, description, and reference as seen in the screenshot below. Click on 'Continue' to proceed.

a) After the payment process has been completed, a success message will be displayed as shown below. From the screenshot below, the user also gets the option of enabling 'Remember Me' to enable the account to be saved for future payments. You can click on continue to be redirected to the redirect URL.

5. b) For the failed payment test experience: Click on 'Failed' and the widget will show that the login failed and will give the user the option of either trying another bank account or closing the payment widget.

b) If the user chooses to close the payment widget, a pop-up showing that the payment wasn't completed will be displayed.

Did this answer your question?