---
title: "Balances"
source_url: https://docs.rapyd.net/en/balances.html
lang: en
---

# Balances

Gain more control over your funds with advanced balance features. | `Enterprise`

Balance types display the amount of funds in a [Rapyd Wallet](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_rapyd_wallet "Rapyd Wallet") at any time. With multiple balance types, Rapyd Wallet provides visibility into all of your funds so you can more effectively manage your cash flow. Balance types are reflected in both Client and User Wallets.

### Balance Types

There are four balance types:

1. Available Balance: available funds for you to use.
2. Received Balance: total amount that has been collected but is not yet available.
3. On Hold Balance: allows you to set money aside and release funds at a later date.
4. Reserve Account Balance: required balance to cover [chargeback](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_chargeback "Chargeback")s, returns, and other items.

   ![balances.jpg](image/img-7cd9de151e307d61562ed10579c8889d.jpg)

   > **Note:**
   >
   > A real-time payment (RTP) includes: transfer from wallet in-network, transfer from bank account, reversal of card authorization, deposit at [POS](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_pos "Point of Sale"), and cancelled payout.

### Available Balance

Funds that can be withdrawn/disbursed by the account owner. Once the [reconciliation](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_reconciliation "Reconciliation") process is completed, the funds that have been received are now moved into the available funds. Most actions interact with the available balance such as payouts, currency conversion, and withdrawals.

### Received Balance

Funds collected and posted to a Rapyd wallet. The funds have not yet settled, and are not yet available for the client to use. The settlement period is determined by the contract/agreement between Rapyd and the client. Funds typically show in received balance when non-real-time payments are received and the funds will settle over time.

### On Hold Balance

The client can control the funds of user wallets, and put funds aside. There are API calls for putting funds on hold and releasing funds that are on hold. This is the only balance type that the client can manipulate.

### Reserve Account Balance

All clients will have a reserve account, these funds are usually in USD, but can be in a different currency based on what is agreed upon in the contract with Rapyd. The reserve shows how much money has been deposited. This is also referred to as the collateral account. The minimum amount required in your reserve account is determined as part of your agreement with Rapyd.

> **Note:**
>
> You can hold multiple currencies as long as you have access to the country's payment method. For example, if you can accept payment methods in the Mexico, Thailand, or Singapore, you can hold their currencies. If you do not have access to one of the country's payment methods (e.g. Japan), you will need to request the PMT as described in [Viewing Payment Methods](https://docs.rapyd.net/en/viewing-payment-methods.md "Viewing Payment Methods").

### Use Case Overview

Client and user wallets examples include any non-real-time payments or real-time payments (RTP) as described below:

### Non-RTP Is Made to the Client Wallet

![non-rtp-to-client-wallet.jpg](image/img-a02ef466728104bd5058c882413e6616.jpg)

1. A non-real-time payment (RTP) is completed and received balance is posted in client's wallet.
2. After maturity time passes, funds move from Received to Available in client's wallet.
3. If client opts to automated settlement the funds settle to client's bank account.

### Non-RTP Is Made to Client Wallet With Disbursement

![non-rtp-to-wallet-with-disbursement.jpg](image/img-df285d48a9d2736300b79184f47738ee.jpg)

1. A non-real-time payment is completed and received balance is posted in client's wallet.
2. After maturity time passes the funds move from Received to Available in client's wallet.
3. Client can use the collected funds to disburse out.

### Bank Transfer or RTP to Client Wallet

![bank-transfer-rtp-to-client-wallet.jpg](image/img-e56118b3216ccff9a9d89ded69c4c79e.jpg)

1. A real-time payment is completed and available balance is credited in client's wallet.
2. Funds immediately available in client's wallet.

### Bank Transfer or RTP to User Wallet

![Bank-Transfer-or-RTP-to-User-Wallet.jpg](image/img-4231537094531ddf1efefcf6274bd2cb.jpg)

1. A real-time payment is completed and available balance is credited in client's wallet.
2. Funds are available in client’s wallet.
3. Client uses Payout API to transfer funds to customer's bank account.

### Escrow Balances

![escrow-balances.jpg](image/img-cdae1c0a450949dd5f2bac63e66c5326.jpg)

1. A non-real-time payment is completed → Received balance is credited.
2. After maturity time passes → Reconciliation (Recon) engine moves funds from Received to Available.
3. You can use the collected funds to payout out to a [beneficiary](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_beneficiary "Beneficiary").

### How Wallet Balances and Funds Work

Create Your Payment to send to a Wallet. Refer to [Integrate Payment Methods](https://docs.rapyd.net/en/integrate-payment-methods.md "Integrate Payment Methods") for more details.

### Retrieve Balances of Wallet Accounts

When the Payment is confirmed you can [retrieve balances of wallet accounts](https://docs.rapyd.net/en/retrieve-balances-of-wallet-accounts.md "Retrieve Balances of Wallet Accounts") with the ID of the Rapyd Wallet.

| Path Parameter | Description |
| --- | --- |
| wallet | ID of the Rapyd Wallet. String starting with ewallet_ |

### Put Funds On Hold and Release Funds

The client can use the [Put Funds on Hold](https://docs.rapyd.net/en/put-funds-on-hold.md "Put Funds on Hold") API Call to place a hold on any designated funds for a user wallet. They can release funds using the [Release On-Hold Funds](https://docs.rapyd.net/en/release-on-hold-funds.md "Release On-Hold Funds").

| Body Parameter | Description |
| --- | --- |
| amount | The amount of the transfer. |
| currency | Three-letter ISO 4217 code for the currency used in the `amount` field. Uppercase. |
| ewallet | ID of the wallet associated with the contact. String starting with `ewallet_`. |

More details on the wallet object are described on the [Transaction Types](https://docs.rapyd.net/en/transaction-types.md "Transaction Types") page.

Refer to the Client Portal Guide for [Wallets](https://docs.rapyd.net/en/wallets.md "Wallets") in Client Portal.
