wallet_trust: verified_only). Whoever verifies an address owns it: unverified copies of it on other accounts stop counting.
Flow
1
Start
POST /v1/platform-users/wallets/verify with the user, the chain and the address. If the address is not yet one of the user’s wallets, it is added.2
Show the payment
Show
amount, currency, receiver and expires_at, the payment_uri as a link for wallet apps, or the QR code from GET /v1/platform-users/wallets/verification/qr.3
Wait for the payment
Poll
GET /v1/platform-users/wallets/verification until status is verified. If the window passes without payment, the status turns expired and you receive the verification.expired webhook.Start a verification
POST /v1/platform-users/wallets/verify
The wallet. It must match the chain: a Solana address on solana, an EVM address on an EVM chain.
external_id.
Response
The verification object, returned by every endpoint on this page.solana:<receiver>?amount=... or ethereum:<receiver>@<chain id>?value=..., for wallet apps and QR codes.Check the status
GET /v1/platform-users/wallets/verification?id=<verification_id>
Returns the verification object with external_id. Open verifications are also listed in the user’s pending_verifications.
QR code
GET /v1/platform-users/wallets/verification/qr?id=<verification_id>
Returns the payment_uri as a QR code, an SVG image (image/svg+xml), not the JSON envelope. Fetch it from your backend and pass it on to your page; your API key must not reach the browser.
Cancel
POST /v1/platform-users/wallets/verification/cancel
Cancels an open verification, for example when the user closes the dialog. Returns the verification object with status cancelled and external_id.
Errors
See Errors for the full list.

