# Balance Mode

Balance mode is the most basic payout method, funds are pre-deposited to contract, deducted from contract balance when paying out.

## How It Works

```mermaid
graph LR
    Merchant[Merchant] -->|Deposit| Contract[Payout Contract]
    Contract -->|Balance| Balance[Contract Balance]
    Balance -->|Deduct| Payout[Payout]

    style Balance fill:#e1f5ff
```

Merchant transfers tokens from wallet to contract address, forming contract balance. When initiating payout, deduct corresponding amount from contract balance and transfer to user.

## Applicable Scenarios

* ✅ **Daily high-frequency payouts**: Such as salary distribution, reward distribution
* ✅ **Funds already consolidated**: Merchant already has large funds in contract
* ✅ **Fixed-amount batch payouts**: Such as rebates, subsidy distribution

## Core Advantages

| Advantage                  | Description                                          |
| -------------------------- | ---------------------------------------------------- |
| **Immediately Available**  | Can be used for payout immediately after deposit     |
| **High Gas Efficiency**    | Low Gas consumption for single payout                |
| **Centralized Management** | Convenient for unified management and reconciliation |

## Usage Flow

### 1. Create Contract

Create balance mode payout contract in BlockATM admin dashboard.

### 2. Deposit

Transfer tokens from your wallet to contract address:

```
Contract address: 0x...  (obtained from admin dashboard)
Deposit amount: your desired pre-deposit amount
```

{% hint style="warning" %}
**Note**: After deposit, funds are in the contract, please ensure contract address security.

**Gas**: TRON network deposit does not require additional Gas; Ethereum network needs to pay Gas.
{% endhint %}

<figure><img src="/files/aWx3eRBBg970tbai8uyM" alt="" width="375"><figcaption></figcaption></figure>

### 3. Create Payout Order

```json
POST /order/api/v2/payout/order
{
  "contractId": "Contract ID",
  "orderNo": "Merchant order number",
  "recipient": "User wallet address",
  "amount": "100",
  "symbol": "USDT",
  "payoutType": 1
}
```

| Field      | Description         |
| ---------- | ------------------- |
| payoutType | 1 = Balance Payment |

### 4. Execute Payout

After admin dashboard review, execute payout, contract balance deducts corresponding amount.

<figure><img src="/files/i9pr81rhrdPeZFKpEspd" alt="" width="375"><figcaption></figcaption></figure>

## Amount Calculation

```
Actual Available = Contract Balance - Locked Amount
```

{% hint style="info" %}
**Locked Amount**: Amount frozen by payout orders currently being executed.
{% endhint %}

## Comparison with Allowance Mode

| Comparison            | Balance Mode         | Allowance Mode           |
| --------------------- | -------------------- | ------------------------ |
| Fund Location         | Contract             | User wallet              |
| Deposit/Authorization | Deposit to contract  | User authorizes contract |
| Fund Risk             | Contract stolen risk | User wallet risk         |
| Fund Efficiency       | Need to pre-deposit  | No pre-deposit required  |
| Whitelist Required    | Must                 | V5.8.0 not mandatory     |

## FAQ

**Q: What tokens does balance mode support?**

A: Supports all ERC20/TRC20/ARB20 tokens.

**Q: Can I use part balance and part allowance?**

A: No, the two methods must be chosen one.

**Q: Is there an upper limit for contract balance?**

A: No upper limit, but recommended not to make single payout amount too large.

**Q: How long after deposit can it be used for payout?**

A: TRON network immediately available; Ethereum needs to wait for one block confirmation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.blockatm.net/payout/balance-mode.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.