> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.paywithatoa.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Atoa Sandbox: Test Payments Before Go-Live

> Test Atoa end to end in the sandbox before going live, simulate Pay by Bank and card flows using test credentials and banks.

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.

<Card icon="webhook" title="Note" href="introduction">
  Refer to the [getting started guide](introduction) for signup, obtaining an
  access token, and creating a payment request. Then, proceed with the steps
  below to simulate different payment scenarios.
</Card>

**Step 1:** <a target="_blank" href="../api-reference/Payment/process-payment" rel="noopener"><b>Generate a Payment Request</b></a> 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.

<Card icon="lightbulb">
  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.
</Card>

| 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.                   |

## Simulating Payment Scenarios in Sandbox

You can simulate all payment outcomes directly using the **Atoa Test Bank**.

**Steps:**

1. Select **Atoa Test Bank** when prompted to choose a bank.

2. After redirection, you will see the **Select Payment Status** screen.

3. Use the dropdown to choose the desired payment outcome:
   * **COMPLETED** — to simulate a successful payment
   * **FAILED** — to simulate a failed payment
   * **PENDING** — to simulate a pending payment

4. After selecting the status, click **Submit** to complete the simulation.