---
title: "Payouts Sandbox Simulator"
slug: "payouts-sandbox-simulator"
updated: 2026-01-02T17:18:57Z
published: 2026-01-02T17:18:57Z
stale: true
---

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

# Payouts Sandbox Simulator

Use payout simulators to troubleshoot issues with available balance payouts to linked bank accounts in a controlled environment. By simulating payout errors and edge cases, you can prepare steps for handling potential errors in the Sandbox before going live.

> [!NOTE]
> Note
> 
> The Merchant portal shows a *Payouts* page in the left navigation panel, while the Partner portal shows a *Withdrawals* page. Although both pages have the same functionality and portal location, they are slightly different in titles and naming conventions.

## Activate Payout Simulators

Trigger each simulator by entering a specific withdrawal amount. Unlike other simulators, all payout simulator triggers work on both Vantiv and VCore platforms for seamless cross-platform payout response simulation.

To trigger a payout simulator:

1. Select **Withdrawals**in the left navigation panel.
2. Click **Schedule Withdrawal**.
3. Select **One Time** from the **How Often** dropdown.
4. Use one of the following triggers for the **Amount** field to simulate a payout processing error:

| **Trigger Amount** | **Simulator Response Message** |
| --- | --- |
| $101.25 | Insufficient funds |
| $201.26 | Account closed |
| $301.27 | Unable to locate account or no account |
| $401.28 | Invalid account number |
| $501.29 | Unauthorized debit to consumer account using Corporate SEC code |
| $601.31 | Returned due to request of ODFI |
5. Select **Actual** from the **Amount Type** dropdown.
6. Click **Create Withdrawal**.

**Result:** The payout simulator returns the platform simulator response message aligned with the amount.

> [!WARNING]
> Important!
> 
> - Payouts in the sandbox environment follow the same processing timeline as in production, so the payout simulator doesn’t return an immediate response message. See [Disbursement Processing Cycle and Timeline](/docs/disbursement-processing-cycle-and-timeline) for details on when payouts are processed.
> - Do not use values outside the specified triggers to activate Sandbox simulators. Non-trigger values return standard successful server responses for normal testing.

## Check Simulator Responses

When triggering the payout simulator with a relevant amount, an artificial platform response is returned with a message explaining the reason.

To find the platform payout simulator response messages:

1. Select **Withdrawals**in the left navigation panel.
2. Select the relevant withdrawal from the **Withdrawal History** section to open the **Withdrawal Details** page.
3. Review the **Alerts**section.

**Result:** The **Alerts** section displays a list of all platform responses to the payout. For payouts using simulator trigger amounts, the Alerts section shows the applicable simulator response message.

The process of creating a disbursement of funds to an entity’s registered deposit account. This process is also known as a *withdrawal*.

The balance of an entity account recorded on the Payrix Pro platform identifying the total balance of the entity’s platform-hosted account balance.

The process of creating a disbursement of account balance funds to an entity’s registered deposit account. This process is also known as a *payout*.