---
title: "Manage the wallet and top-ups"
description: "Check your organization wallet balance, add funds with a top-up, and see what the wallet can pay for."
canonical_url: "https://docs.hustlx.com/payments/wallet-and-top-ups"
---
# Manage the wallet and top-ups

> Check your organization wallet balance, add funds with a top-up, and see what the wallet can pay for.

The organization wallet holds funds your organization adds to HustlX. It is a local ledger of credits, debits, and adjustments, so its balance comes from HustlX ledger entries, not from any payment provider balance.

<note title="Who can do this">

Organization owners (**Super Admin**) and **Organization Admin** members. The wallet needs active Annual Registration, including its three-day grace period. Your account email must be verified to submit a top-up.

</note>

## Before you start

- Make sure Annual Registration is active. See [Buy Annual Registration and add-ons](https://docs.hustlx.com/payments/annual-registration).
- Know the amount you want to add, in pesos.

## What the wallet can pay for

You can use an existing wallet balance at subscription checkout for Annual Registration and annual add-ons. The **Wallet** option appears only when the balance covers the subtotal. League team admissions are paid through hosted checkout only, never from the wallet.

Wallet top-up and fixed-price entitlement checkout are separate flows. A top-up only adds funds; it never buys an entitlement by itself.

## Open the wallet

<steps level="3">

### Go to Wallet & Subscription

Open your organization's **Manage** area, then open **Billing** and select **Wallet & Subscription**.

### Review your balance and activity

The page shows:

- **Wallet balance**, with the amount pending in open top-ups listed under it.
- **Recent activity**: date, description, and amount for each wallet entry.
- **Top-up requests**: each request with its amount, status, and request date.

![Wallet and Subscription page showing the wallet balance, Recent activity, and Top-up requests](https://docs.hustlx.com/screenshots/payments/wallet-and-top-ups-wallet.png)

</steps>

## Add funds

Select **Top up** to open **Top up organization wallet**. The dialog uses the path your organization is set up for. There is no selector between them: **Top up now** means online checkout, and **Submit top-up** means manual review.

<tabs>
<tabs-item label="Online top-up">

New hosted checkout sessions use the HustlX master payment account. Your organization does not need its own payment account.

<steps level="3">

### Enter the amount

Type the amount in **Amount**, for example `500` for PHP 500. If a transaction fee applies, the dialog shows the fee and the total you will be charged.

![Top up organization wallet dialog with an amount entered and the Top up now button](https://docs.hustlx.com/screenshots/payments/wallet-and-top-ups-online-top-up.png)

### Pay through hosted checkout

Select **Top up now** once and complete payment on the secure hosted page.

### Wait for the credit

Return to **Wallet & Subscription**. The verified webhook confirms the payment and posts the wallet credit; until then the request shows as pending.

</steps>
</tabs-item>

<tabs-item label="Manual proof-of-payment top-up">

Use this path only when the dialog shows **Payment method** and **Proof of payment**.

<steps level="3">

### Choose a payment method

Enter the **Amount** and choose a **Payment method**. Check the recipient details shown for that method.

### Transfer and record the payment

Send the exact amount through your bank or payment app. Enter the **Payment reference** and an optional **Note** for the reviewer.

### Upload your proof

Under **Proof of payment**, upload a PNG, JPG, or HEIC receipt up to 20 MB. It should show the amount, recipient, date, and reference number.

### Submit for review

Select **Submit top-up**. The wallet is credited only after a HustlX reviewer approves the request.

</steps>

<warning>

Manual proof-of-payment applies to wallet top-up only. You cannot use it to buy Annual Registration, add-ons, or league team admissions.

</warning>
</tabs-item>
</tabs>

## What happens next

- **Pending**: online checkout, payment confirmation, or manual review is still in progress.
- **Approved**: the credit is posted to your wallet balance.
- **Rejected**: the manual proof could not be verified, or the online checkout did not complete.

A success page after checkout is navigation only. Staff cannot replace verified payment confirmation with a manual approval.

## Troubleshooting

### I returned from checkout but the balance did not change

The balance updates after the payment is verified. Wait briefly and refresh. If the request stays pending, select **Retry payment** on it. This resumes the checkout, or cancels it and starts a new one.

### I expected online checkout but see the manual form

Online payments are not enabled for your organization right now, so the dialog shows the manual path. Use it, or contact support if you need online top-up.

### My manual request was rejected

Read the rejection reason, then submit a new request with a clearer receipt that shows the amount, recipient, date, and reference.

### The Wallet option does not appear at subscription checkout

The balance must cover the full subtotal, and you must have wallet access. Otherwise, use secure checkout or top up first.

### The balance differs from my records

Match the **Recent activity** entries by date and description, then contact support with the details.

## Related guides

- [Buy Annual Registration and add-ons](https://docs.hustlx.com/payments/annual-registration)
- [Track finances and request payouts](https://docs.hustlx.com/payments/finance-and-payouts)
- [Settings and members](https://docs.hustlx.com/organizations/settings-and-members)


## Sitemap

See the full [sitemap](https://docs.hustlx.com/sitemap.md) for all pages.
