> ## Documentation Index
> Fetch the complete documentation index at: https://developer.tazapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Simulating Increasing Balance

> Top up your sandbox balance to test the end-to-end payout flow without using real money.

## Overview

To test payout flows in the sandbox, your account needs a balance to fund them. Since no real money moves in the sandbox environment, you can simulate an incoming collect to generate a dummy balance in your test account.

Once the simulated collect settles, the credited amount becomes available in your balance and can be used to fund payout requests — letting you test the complete flow from receiving funds to disbursing them.

***

## How to Simulate a Balance Top-up

<Steps>
  <Step title="Open Virtual Accounts">
    In the [Sandbox Dashboard](https://dashboard-sandbox.tazapay.com), navigate to **Virtual Accounts** in the left sidebar. Select an **Active** virtual account.

    <Frame>
      <img src="https://mintcdn.com/tazapay-58ae360f/s79kF3FjPnRcJHfX/images/sandbox-simulate-collect-va.png?fit=max&auto=format&n=s79kF3FjPnRcJHfX&q=85&s=e01d255d58d039767939539a3a9fe2a7" alt="Virtual Accounts — select an active account and click Simulate Collect" width="2000" height="1304" data-path="images/sandbox-simulate-collect-va.png" />
    </Frame>
  </Step>

  <Step title="Click Simulate Collect">
    On the virtual account detail panel, click the **Simulate Collect** button in the top-right corner.
  </Step>

  <Step title="Set collect status and amount">
    In the modal that appears, set **Collect status** to `Succeeded` and enter the **Amount** you want to credit to your balance. Click **Confirm**.

    <Frame>
      <img src="https://mintcdn.com/tazapay-58ae360f/s79kF3FjPnRcJHfX/images/sandbox-simulate-collect-modal.png?fit=max&auto=format&n=s79kF3FjPnRcJHfX&q=85&s=7760153bc23579e03d0d4b65ebeef7cf" alt="Collect modal — set status to Succeeded and enter an amount" width="1166" height="608" data-path="images/sandbox-simulate-collect-modal.png" />
    </Frame>
  </Step>
</Steps>

Once confirmed, the simulated collect settles and the specified amount is added to your sandbox balance. You can then use this balance to fund payout requests.

***

## Collect State Flows

You can simulate a collect into any of the following states depending on the scenario you want to test.

<Tabs>
  <Tab title="Fiat">
    | State Flow            | Description                                                           |
    | --------------------- | --------------------------------------------------------------------- |
    | `on_hold → succeeded` | Collect held for review and, upon clearance, settled to the merchant. |
    | `on_hold → failed`    | Collect held for review and rejected — compliance failure.            |
    | `succeeded`           | Collect settled successfully.                                         |
    | `failed`              | Collect rejected outright.                                            |
  </Tab>

  <Tab title="Crypto">
    | State Flow                       | Description                                                                                                                                      |
    | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
    | `on_hold → detected → succeeded` | Collect held for review, cleared, then detected on the blockchain. Once confirmed on-chain, the collect settles successfully.                    |
    | `on_hold → detected → failed`    | Collect held for review, cleared, then detected on the blockchain but the on-chain transaction ultimately failed or was rejected post-detection. |
    | `on_hold → succeeded`            | Collect held for review and, upon clearance, settled to the merchant.                                                                            |
    | `on_hold → failed`               | Collect held for review and rejected — compliance failure.                                                                                       |
    | `detected → failed`              | Crypto transaction detected on the blockchain but never confirmed.                                                                               |
    | `detected → succeeded`           | Crypto transaction detected on the blockchain and successfully confirmed on-chain. Funds settled to merchant.                                    |
    | `succeeded`                      | Collect settled successfully.                                                                                                                    |
    | `failed`                         | Collect rejected outright.                                                                                                                       |
  </Tab>
</Tabs>

<Note>
  For testing payouts, use the `succeeded` state — this is the only flow that credits your balance and makes funds available for payout funding.
</Note>