# Treasury Wallet

In Pay.io, we offer **a two-wallet system** —[ **Hot Wallet**](https://docs.pay.io/assets/hot-wallet) and **Treasury Wallet**. 

The **Treasury Wallet** is your secure, **self-custody** storage for funds held outside the active payment layer. 

Unlike the Hot Wallet, which is managed by Pay.io to support day-to-day player transactions, **the Treasury Wallet is held entirely under your custody via passkey authentication**. Pay.io does not have access to these funds or holds them. 

Think of it as your **vault**. It sits outside the operational layer, protecting your profits and surplus balances from exposure, whilst remaining accessible whenever you need to replenish your Hot Wallet or withdraw funds to an external destination entirely.

{% hint style="warning" %}
Treasury Wallet can be configured after [**Business Verification** ](https://docs.pay.io/getting-started/how-to-get-started#compliance-verification-kyb-and-aml) procedures are **completed**.
{% endhint %}

### What's in the Treasury Wallet

The Treasury Wallet page gives you full visibility over your secured holdings through key views:

**Secure Storage value** which shows the total combined value of assets held in your Treasury Wallet

**Balance Overview** which displays a per-asset breakdown of all funds currently held in your Treasury Wallet. Each row displays the asset, network, and current balance in crypto and fiat, giving you a clear picture of your total secured holdings at a glance.

**Key Actions** allowing you to initiate inbound and outbound movement — a deposit directly to Treasury Wallet, a transfer back to your Hot Wallet, or a withdrawal to an external wallet or exchange. 

***

### Treasury Wallet vs. Hot Wallet At a Glance

|                        | Hot Wallet                                                                            | Treasury Wallet                                           |
| ---------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| **Purpose**            | Operational liquidity for active payment flows                                        | Secure storage of surplus and profit funds                |
| **Custody**            | Managed by Boomfi                                                                     | Under your own custody (passkey-protected)                |
| **Funded by**          | Manual deposits, transfers from Treasury                                              | Automatic sweeps, Hot Wallet transfers, external deposits |
| **Outbound transfers** | Player withdrawals and deposits, sweeps to Treasury and manual transfers to Treasury. | Transfers to Hot Wallet, withdrawals to external wallets. |
| **Player-facing**      | Yes — powers deposits and withdrawals                                                 | No                                                        |
| **Pay.io access**      | No                                                                                    | No                                                        |

***

### Setting up the Treasury Wallet (Admin only)

Treasury Wallets are set up automatically by Pay.io whenever a new asset is added and configured in your Hot Wallet — there is no need to create them manually on a per-asset basis. 

However, before any Treasury Wallet can be used, a **one-time setup** is required to register your passkeys and confirm the wallets under your custody. You'll be prompted to complete the passkey registration when setting up your wallets. 

<figure><img src="https://3833492769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnW0Bk5BiuEPyZlHrzxgL%2Fuploads%2FNXDilptuKLxrAfCscv2c%2FScreenshot%202026-02-12%20at%2011.35.34.png?alt=media&#x26;token=6b14341c-3a25-49ce-8ac7-3b8758d0f17a" alt="" width="462"><figcaption><p>Passkey Registration pop-up for Treasury Wallet configuration</p></figcaption></figure>

#### **Prerequisites**

* At least one asset must be configured and active in your **Hot Wallet**. See [Asset Management](https://docs.pay.io/assets/asset-management-add-edit-disable) for guidance.

#### **First-Time Setup**

{% stepper %}
{% step %}

### **Navigate to the Treasury Wallet Page**

From the left-hand navigation, select **Treasury Wallet**. If no Treasury Wallets have been confirmed yet, you will be prompted to complete the setup flow.
{% endstep %}

{% step %}

### **Register Your Passkeys**

You will be asked to register a passkey for your Treasury Wallet. This passkey is the authentication mechanism that places Treasury wallet with its assets under your **sole** **custody** — it is not stored or accessible by Pay.io.

Passkey Registration is done using OpenWallet for secure wallet management. The passkey won't be in anyone else's custody besides your own (not Pay.io or OpenWallet). \
\
Follow the on-screen prompts to complete passkey registration on your device, you may need to install OpenWallet to your device or browser to complete this step.&#x20;

<figure><img src="https://3833492769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnW0Bk5BiuEPyZlHrzxgL%2Fuploads%2FNXDilptuKLxrAfCscv2c%2FScreenshot%202026-02-12%20at%2011.35.34.png?alt=media&#x26;token=6b14341c-3a25-49ce-8ac7-3b8758d0f17a" alt="" width="462"><figcaption><p>Passkey Registration pop-up for Treasury Wallet configuration</p></figcaption></figure>

{% hint style="info" %}
**Store your passkey credentials securely.**

Loss of your passkey may prevent access to your Treasury Wallet funds. Pay.io cannot recover access on your behalf.
{% endhint %}
{% endstep %}

{% step %}

### **Create Treasury Wallet With Your Passkeys**

After you've set up your passkey hash in OpenWallet, it will be registered in OpenWallet.&#x20;

Once registered, you will be asked to sign the wallet creation request using your newly registered passkey. This cryptographically confirms your ownership of the Treasury Wallets being created.

<figure><img src="https://3833492769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnW0Bk5BiuEPyZlHrzxgL%2Fuploads%2F3RMf40nIQpXKpZcGtSIf%2FScreenshot%202026-03-11%20at%2011.10.12.png?alt=media&#x26;token=e432054e-2f54-4459-b120-7996dd8d2ff3" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Finalise the Process**

Review the wallets to be created — one per configured asset network — and click "Done". Your Treasury Wallets will now be active and ready to receive funds.

<figure><img src="https://3833492769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnW0Bk5BiuEPyZlHrzxgL%2Fuploads%2F2A0ZG22ZcScuGyQZynnF%2FScreenshot%202026-03-11%20at%2011.10.29.png?alt=media&#x26;token=e710d8fa-3e0a-47fc-a73f-df335d7a1e01" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### How the Treasury Wallet Is Funded

The Treasury Wallet can be funded in three ways:

| Funding Method                | Description                                                                                                                                                                                                                                                                                                          |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Automatic Sweeps**          | When your Hot Wallet balance exceeds the maximum retained threshold you have configured, funds are automatically transferred to your Treasury Wallet. This is the primary funding mechanism for most operations. See how to [set up sweep logic per asset](https://docs.pay.io/assets/setting-up-sweeps-and-alerts). |
| **Transfers from Hot Wallet** | You can manually initiate a transfer from your Hot Wallet to the Treasury Wallet at any time from the Hot Wallet page.                                                                                                                                                                                               |
| **External Wallet Deposits**  | Treasury Wallets can also receive funds directly from any external wallet or exchange, bypassing the Hot Wallet entirely.                                                                                                                                                                                            |

***

#### What's Next?

* [Setting up Sweeps and Alerts](https://docs.pay.io/assets/setting-up-sweeps-and-alerts) to automate the movement of excess funds from your Hot Wallet into your Treasury Wallet.
* [Transfer From Hot Wallet to Treasury Wallet](https://docs.pay.io/assets/treasury-wallet/transfer-from-hot-wallet-to-treasury-wallet) to manually move surplus funds from your operational float into secure self-custody storage.
* [Transfer From Treasury Wallet to Hot Wallet](https://docs.pay.io/assets/treasury-wallet/transfer-from-treasury-wallet-to-hot-wallet) to replenish your operational float by moving funds back into the Hot Wallet.
* [Depositing to Your Treasury Wallet](https://docs.pay.io/assets/treasury-wallet/deposit-to-treasury-wallet) to fund your Treasury Wallet directly from an external wallet or exchange.
* [Withdrawing From Your Treasury Wallet](https://docs.pay.io/assets/treasury-wallet/withdraw-from-treasury-wallet) to send funds from your Treasury Wallet to an external wallet or exchange, exiting the Pay.io system entirely.