Skip to content

Wallet Verification

Get started with the Widget or a custom API integration

Verify a customer's self-hosted wallet as part of a deposit, withdrawal, or wallet-linking journey. Choose how to integrate, then enable the ownership methods and supporting checks your policy requires.

Choose how to integrate

Widget (recommended)

The Widget is ready to use and supports all wallet verification features: ownership flows, additional evidence steps, and reusable verification. It is highly customisable, including branding, colours, fonts, languages, and the available verification methods.

Embed it in your application as a Web Component, or send customers to the hosted verification page. Your backend creates the verification; the Widget handles the customer journey. Follow the Widget integration guide to get started.

Custom API integration

Use the API when you want to build your own web or native mobile UI. Your backend creates the verification, submits customer evidence, and handles results. Follow the custom API integration guide.

For either approach, reconcile results through webhooks or a server-side status check. Store the verification ID with your customer or transaction record.

Verification flows

Choose one or more ownership methods when creating the verification:

FlowWhat the customer doesResult
Signature ProofSigns an off-chain message with their wallet.CryptoSwift verifies the signature automatically.
Satoshi TestSends a specified small amount to your deposit address.CryptoSwift monitors for a matching transaction.
Visual ProofUploads wallet screenshots or media.Your team reviews the evidence.
Self-DeclarationDeclares that they own the wallet.The declaration is recorded without a signature or transaction.

Check supported blockchains and methods before enabling a flow.

Additional steps

Request supporting checks in the same verification journey:

  • Source of Funds / Source of Wealth (SoF/SoW): collect documents for manual review.
  • Selfie / Liveness: guide the customer through a selfie capture with backend liveness analysis and optional automatic approval.

The Widget handles these steps, or you can implement them through the API. Each step has its own status; verified wallet ownership does not mean every requested check is complete. See the Additional Steps integration guide for setup, submission, and review.

Reusable verification

Avoid asking an eligible customer to prove the same wallet again. Include reuse when creating a verification so CryptoSwift can match previous ownership evidence against your policy. If no eligible match exists, the customer completes the normal flow. See Reusable Wallet Verification for matching requirements and implementation.

Find the right verification option

NeedDetails
Launch a ready-to-use customer journeyWidget
Build your own customer UICustom API integration
Collect SoF/SoW or Selfie / Liveness evidenceAdditional steps
Reuse eligible ownership evidenceReusable verification
Help a customer whose wallet cannot connect for signingManual message signing
Check chain supportSupported blockchains
Check pricingCredit usage

Next steps