Sandbox Guide
The Sandbox environment lets you develop and test your integration without touching live payments.
Sandbox Environment
Atoa’s sandbox environment is a self-contained environment that simulates the live production environment. The sandbox provides a space where you can initiate, experiment and watch transactions without touching a live bank account. We highly recommend that you use the sandbox before generating the production keys.
The sandbox mirrors all the features of the live environment but has some minor differences that make it easy to test flows. Please follow the sandbox guide to know more.
Atoa Sandbox environment guide
The Sandbox serves as a testing environment enabling merchants to simulate the end-to-end payment process. Merchants can use sandbox credentials to simulate different scenarios, such as successful payments, failed payments, and pending payments.
Note
Refer to the getting started guide for signup, obtaining an access token, and creating a payment request. Then, proceed with the steps below to simulate different payment scenarios.
Step 1: Generate a Payment Request using sandbox access.
Step 2: Open the payment URL or scan the QR code URL using your phone’s camera.
Step 3: Simulate the Payment Scenarios.
The actual sandbox provided by the bank may not work sometimes, so we prefer using the Atoa Test bank to simulate all scenarios, such as successful, failed, or canceled payments, as given in the table below.
| Payment Scenario | Description |
|---|---|
| COMPLETED | shows that the payment has been processed successfully. Funds have been transferred to the merchant’s account. |
| PENDING | shows that the payment is currently in progress and awaiting final confirmation from the bank. |
| FAILED | Unsuccessful transactions are marked as failed. The customer will have to retry the payment. |
Follow these steps to simulate different scenarios with sandbox provided by the banks.
3(a) Simulate a Successful Payment.
Select the ‘Mock ASPSP V1’ bank for payment completion. Authorization will be swiftly finalized upon redirection, confirming a successful payment.
3(b) Simulate a Cancelled payment.
Select “Royal Bank of Scotland” to simulate a cancelled payment. Enter the customer number as 123456789012 and input the following PIN as 572,436. Click on “Cancel Payment,” and then confirm the action.
3(c) Simulate a Failed Payment.
Select “Royal Bank of Scotland.” Enter the Customer Number as 123456789012 input the following PIN as 572,436. Choose an account and click on confirm payment. This will result in a failed payment outcome.
3(d) Simulate a Pending Payment.
Select “Modelo Sandbox”. Log in with “username: mits” and “password: mits” . Choose an account and click on confirm payment. This will result in a Pending payment.