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

# Addresses

> The merchant dashboard Crypto > Addresses page — manage saved wallet/withdrawal addresses: add addresses, filter by network/type/coin/whitelist, edit labels, add or remove from the whitelist, start address verification, withdraw from an address, and delete addresses.

## What this is

This is the **Addresses** page under the **Crypto** module in the merchant dashboard (left nav **Crypto** → **Addresses**; page subtitle "Manage saved wallet addresses"). Here you maintain a book of saved wallet/withdrawal addresses: add addresses, see each address's verification and whitelist status, edit labels, add or remove addresses from the whitelist, start verification on personal addresses, withdraw from an address, and delete addresses. Before making a crypto withdrawal, save your common receiving addresses here and (if needed) complete verification, so you can select them directly when withdrawing.

## Steps

Open the Addresses page:

1. In the left nav, click **Crypto**.
2. Select **Addresses**.
3. The list shows all saved addresses by default; use the toolbar's **Network / Type / Whitelist / Coin** filters or search to narrow it down.

Add a new address:

1. Click **Add Address** in the top right to open the **Add Withdrawal Address** dialog.
2. Fill in the **Address label** (4-20 characters, used to identify this address).
3. Choose the **Network** and **Coin**; if you want the address usable for any coin on the same network, set it as a **Universal** address.
4. Enter the wallet **Address**, and fill in address type, address source, and compliance information as needed.
5. If needed, check **Add to whitelist**; check the declaration and submit to save.
6. After saving, complete verification for the address as soon as possible to avoid delays processing later withdrawal requests.

Filter and search:

1. **Network**: filter by Ethereum / BSC / Bitcoin / Tron / Polygon / Solana, or **All Networks**.
2. **Type**: filter by **Exchange** or **Personal**, or **All Types**.
3. **Whitelist**: filter by **Whitelisted / Not Whitelisted**, or **All**.
4. **Coin**: filter by the address's coin (options come from coins present in the current list), or **All Coins**.
5. **Search**: search by label or address.
6. Active filters appear as tags in the **Filtered by** area; click the "x" on a tag to remove it, or click **Clear all** to clear everything.

Manage a single address: hover to the end of a row and click the **...** menu to see the actions available for that address's type and status (see "Inline actions" below). Click a row to open the **Address Details** panel on the right for full information.

## Fields and statuses

**List columns:**

| Column    | Meaning (merchant view)                                                        | Notes                   |
| --------- | ------------------------------------------------------------------------------ | ----------------------- |
| Label     | The name you gave the address, with its verification status shown below        |                         |
| Address   | The wallet address, truncated in the list (leading/trailing characters)        | Hover for a copy button |
| Coin      | The coin bound to this address; shows **Universal** if not limited to one coin |                         |
| Network   | The blockchain network this address belongs to                                 |                         |
| Type      | **Exchange** or **Personal**                                                   |                         |
| Whitelist | Whether it's whitelisted: **Yes / No**                                         |                         |
| Created   | When the address was added                                                     |                         |

**Top stats bar:** **Total**, **Verified**, **Pending**, **Whitelisted** — the total number of addresses, the number that have completed verification, the number pending verification, and the number whitelisted.

**Address verification status** (shown below the label):

| Status     | Meaning                                               |
| ---------- | ----------------------------------------------------- |
| Verified   | The address has completed verification                |
| Pending    | Verification is in progress, not yet complete         |
| Failed     | The last verification attempt failed (can be retried) |
| Unverified | Verification has not been started                     |

> Only **Personal** type addresses go through the verification flow and show a verification entry point; **Exchange** type addresses do not show verification.

**Address Details panel** (opens when you click a row): shows the address label and type, wallet address, address information (recipient name, network, coin, type), compliance information (Travel Rule: wallet type, address party, and other information entered when adding the address — shown only when the address has this data), and security (whitelist, verification status, created date).

**Inline actions ("..." menu):** the "..." menu on an address's row shows the following actions depending on its type, verification status, and your permissions:

* **Verify address / Continue verification / Retry verification** — start, continue, or retry verification for a **Personal** address, entering the address verification flow (see the "Verify Address" page). Shows **Verify address** if not yet verified, **Continue verification** if verification is in progress, and **Retry verification** if the last attempt failed.
* **Withdraw** — start a crypto withdrawal from this address (requires withdrawal permission; not shown for unverified addresses).
* **Edit label** — change the address's label (4-20 characters).
* **Remove from whitelist** — shown only when the address is already whitelisted.
* **Delete address** — delete the address; this action cannot be undone.

> Which actions are shown depends on the address type (Exchange/Personal), its verification status, and your account's permissions.

## Edge cases and troubleshooting

* **List shows "No addresses yet"**: the address book has no addresses yet; the hint reads "Addresses will appear here once added." — click **Add Address** to add one.
* **Filtering shows "No addresses match your filters"**: no addresses match the current filters; the hint reads "Try adjusting your filter criteria." — click **Clear filters** or **Clear all** and look again.
* **An address has an orange compliance-info reminder badge**: the address is missing compliance (Travel Rule) information — click the badge to open a dialog and complete it (**Complete compliance info**).
* **You don't see "Verify address" in an address's "..." menu**: the verification entry only shows for **Personal** type addresses that are unverified/pending/failed; **Exchange** type or already-verified addresses don't show it.
* **You don't see "Withdraw" in an address's "..." menu**: unverified addresses cannot be withdrawn from — complete verification first; you also need withdrawal permission on your account.
* **You don't see "Add Address / Edit label / Delete / Remove from whitelist"**: these are write actions that require the corresponding permission; they're hidden if you don't have it.
* **The address is only partially shown**: the list truncates addresses for display — hover the copy button next to an address in its row to copy the full address.

## Common questions (Q\&A)

* **Q: Where do I manage crypto withdrawal addresses? / How do I add a receiving address?** A: Left nav **Crypto** → **Addresses**, click **Add Address** in the top right, fill in the label, choose network and coin, enter the address, and save.
* **Q: Why can't I withdraw to the address I just added?** A: Unverified addresses can't be used for withdrawals. Select **Verify address** from that address's "..." menu to complete verification, then withdraw from **Withdraw**.
* **Q: What verification statuses exist?** A: Verified, Pending, Failed, Unverified. Only **Personal** type addresses go through the verification flow.
* **Q: What does the "Pending" status mean?** A: The address's verification is in progress and not yet complete; you can select **Continue verification** from the "..." menu to finish it.
* **Q: What do I do if verification failed?** A: Select **Retry verification** from that address's "..." menu to start verification again.
* **Q: How do I add or remove an address from the whitelist?** A: To add, check **Add to whitelist** when adding the address; to remove, select **Remove from whitelist** from that address's "..." menu.
* **Q: What's the difference between "Exchange" and "Personal" under Type?** A: Exchange addresses are receiving addresses at a trading platform, Personal addresses are individual wallet addresses; only Personal addresses need to go through verification.
* **Q: What does "Universal" coin mean?** A: The address isn't limited to a specific coin — any coin supported on that network can use it to receive funds.
* **Q: How do I rename an address?** A: Select **Edit label** from that address's "..." menu; the label must be 4-20 characters.
* **Q: How do I delete an address?** A: Select **Delete address** from that address's "..." menu and confirm; deletion cannot be undone.
* **Q: Which networks are supported?** A: Ethereum, BSC, Bitcoin, Tron, Polygon, Solana.
* **Q: How do I filter / search the address list?** A: Use the toolbar's **Network / Type / Whitelist / Coin** filters, or search by label or address.
* **Q: What's that orange reminder on an address?** A: It means the address is missing compliance (Travel Rule) information — click it to fill in the details.
* **Q: Can I bulk-export addresses?** A: Bulk export isn't available right now — contact support or your account manager if you need it.
* **Q: What step is my address's verification at right now?** A: That's real-time, per-address progress — refer to the verification status shown in the list and the Address Details panel; this material doesn't provide case-specific conclusions.