Verify a wallet manually
Before you start
Section titled “Before you start”- You have the Start wallet verification permission. (Who can use it)
- To attach a file, you also need permission to edit the wallet’s account: Add and edit contacts for a contact’s wallet, Manage entities for one of your entities’ wallets, or Manage team for a teammate’s. Without it, a note on its own is enough.
- The wallet is already in Mezzanine. If it isn’t, see
Adding the wallet now?
below. - You have your evidence to hand: a screenshot or document showing the owner controls the wallet (a block explorer view, a portal confirmation or a signed message), a note on how you know, or both.
- Optionally, the hash of an earlier transaction this wallet sent or received.
- In the sidebar, click Legal & Compliance → Wallet Verification.You see the Wallets tab.
- Find the wallet. Open the ⋮ menu at the end of its row and click Verify manually.
Or click Verify wallet (or Reverify) in the same menu, then click Verify manually in the Verify wallet window.A window opens titled Verify manually, reading “Attest that address is the correct wallet”.
- Under Evidence of control, click Upload a screenshot or document and choose one or more files, or drag them onto it.Each file is listed with its size. Click the bin icon beside a file to remove it.If you see
Attaching a file needs permission to edit this account. A note on its own is enough.
instead, go on to step 4. - In Note, say how you know the wallet is theirs, for example
Confirmed on a call with their finance lead on Jul 5
. You need a file, a note, or both.The counter under the note shows how many of its 2,000 characters you’ve used. - Under What this wallet is for, check Networks and Assets. They start with what the wallet already lists. Pick the ones the owner can receive, or All Networks / All assets to accept everything. For a Safe or an onchain exchange account, Networks is fixed to the account’s own network: “This account lives on network, so it’s verified for that network only.”
- Optionally, under Prior transaction, paste a Transaction hash and choose the Network it was sent on.
Mezzanine checks it on-chain: it must exist, not have reverted, and involve this wallet.
A Safe or an onchain exchange account only counts transactions on its own network, so its network is already chosen. - Click Verify.The window reads Verifying wallet while the address is screened, then closes, and you see
Wallet verified manually
. - Find the wallet’s row again.It now reads Verified manually · today’s date. Hover over it to see who verified it and when, e.g.
Verified manually by Dana Reyes on Jul 5, 2026.
The wallet’s panel on the right lists what you chose in step 5 under Accepts.
You’re done. The wallet can be paid on the networks and assets you chose.
Adding the wallet now? Click Actions at the top right, then Add Wallet. Fill in Wallet owner and Wallet address, and click Continue. On Send a test transaction?, click Verify manually instead. The wallet is saved, and the Verify manually window opens: carry on from step 3. From 3rd Party Accounts, the Send a test transfer? step offers the same.
In the middle of a payment? Wherever a payment warns that its destination wallet isn’t verified for it (on its own page, in Requires Action, or in the window where you approve, authorize, propose, sign or execute it), click Verify manually in the warning. The Verify manually window opens on top, with the payment’s network and asset already selected: do steps 3–7. The warning clears once the wallet is verified for the payment’s network and asset.
A test is waiting on the owner? Verifying manually replaces it, and the link you sent them stops working.
If something goes wrong
Section titled “If something goes wrong”| You see | Why | What to do |
|---|---|---|
| No Verify manually in the row’s ⋮ menu | The wallet is already verified, or it’s blocked by OFAC screening | For a verified wallet, click Reverify in the same menu, then Verify manually. A blocked wallet can’t be verified |
Add a screenshot or a short explanation first |
You attached no file and left Note empty | Attach a file, write a note, or both |
Attaching a file needs permission to edit this account. A note on its own is enough.in place of Upload a screenshot or document |
You can’t edit the wallet’s account | Write a note instead, or ask an admin for the permission |
Keep the note under 2,000 characters |
The note is too long | Shorten it. Put the detail in a document and attach it instead |
Attach at most 5 files |
More than 5 files are attached | Remove some, or combine them into one document |
File type not supported. Allowed: PDF, DOCX, XLSX, PNG, JPG, HEIC, CSV, MD. |
The file isn’t one of those types | Save it as one of them and attach it again |
File exceeds 25MB limit. |
The file is larger than 25 MB | Attach a smaller file, such as a screenshot |
Choose at least one networkor Choose at least one asset |
Networks or Assets is empty | Pick at least one, or All Networks / All assets |
Enter the full transaction hash |
The hash is incomplete | Paste the whole hash: 0x followed by 64 characters |
| “Transaction not found on network” | The network you chose has no transaction with that hash | Check the hash, and choose the network it was sent on |
Transaction reverted |
The transaction failed on-chain | Cite one that went through, or leave Prior transaction empty |
Transaction does not involve this wallet |
The wallet didn’t send or receive anything in that transaction | Cite one this wallet took part in, or leave Prior transaction empty |
The network couldn’t be read right now. Try again in a moment. |
Mezzanine couldn’t reach the network to check the transaction | Click Verify again shortly |
This address was flagged by OFAC screening, so it can’t be verified. |
The address matched a sanctions list | Stop. Don’t pay this wallet. Raise it with whoever handles compliance |
Sanctions screening is unavailable right now, so the wallet can’t be verified. Try again later. |
The address couldn’t be screened, and nothing is verified unscreened | Click Verify again later |
A test transaction to this wallet is still in flight. Wait for it to settle, then try again. |
A test deposit to this wallet is still being sent | Wait a few minutes, then click Verify again |
This account changed while you were verifying it. Close this window and try again. |
Someone edited or removed the wallet while you were verifying it | Close the window, check the wallet, and start again |