Turn on Wallet Verification Mode

Goal

Make sure no one in your organization pays an unverified wallet without seeing a warning and confirming it, and keep a record of every time someone goes ahead anyway.

How it works

With Wallet Verification Mode on, anyone who approves, proposes, signs or executes a payment to a wallet that hasn’t been verified for that payment sees a warning. They must tick a box to continue. Each time they do, the payment is added to the Bypass log. The payment isn’t blocked; the mode makes skipping verification a deliberate, recorded choice. New organizations start with it on.

For what verification is and how it works, see Wallet Verification.

Before you start

• You have the Edit general organization settings permission. (Who can use it)

Turn it on

1. In the sidebar, click System Controls → Organization Settings.
   You see General Settings.
2. Find Wallet Verification Mode, described as Require counterparty wallets to pass verification before funds can be sent to them. If the switch is already on, there’s nothing to do.
3. Click the switch.
   A window opens titled Turn on wallet verification mode?
4. Click Turn on.
   You see Wallet verification mode turned on. and the switch is on.

What changes while it’s on

In payments. When a payment in Approve Payments goes to a wallet that isn’t verified for it, the approve, propose, sign and execute windows show a warning:

Warning	Why
Destination wallet not verified	The wallet has never passed a test transaction
Network not verified for this wallet	The payment uses a network the owner didn’t confirm
Asset not verified for this wallet	The payment sends an asset the owner didn’t confirm

The confirm button stays off until the person ticks I understand this wallet isn’t verified for this payment and want to proceed. The box resets each time the window opens, so every approver and signer confirms for themselves.

On a contact’s wallet. Opening a wallet from a contact’s profile shows its verification state at the top, with the next step: Send test for an Untested wallet, Review test while a test is pending, and Resend test after a failed or locked test.

In the Bypass log. Every payment that goes ahead past the warning is recorded at each stage it reaches: Approved, Proposed, Signed or Executed. To see it, click Legal & Compliance → Wallet Verification → Bypass log. Each entry shows when, who, which payment and wallet, the network, and the reason: Untested, Network not in list or Asset not in list.

Turning it off

Click the switch again, then Turn off. Warnings and prompts stop across the app for everyone; wallets you’ve already verified stay verified. Payments made while the mode is off don’t appear in the Bypass log, even after you turn it back on.

If something goes wrong

You see	Why	What to do
The switch is dimmed, and clicking it says You do not have permission to edit general organization settings	You don’t have Edit general organization settings	Request the permission from the message, or ask an admin
Failed to update wallet verification mode. Please try again.	The change didn’t save	Try again
A payment’s confirm button won’t turn on	The wallet isn’t verified for this payment, and the box isn’t ticked	Verify the wallet first (Verify someone’s wallet with a test transaction), or tick the box if you’re sure of the destination
The Bypass log reads No bypasses recorded	No one has paid past the warning while the mode was on	Nothing to do