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:
| Flow | What the customer does | Result |
|---|---|---|
| Signature Proof | Signs an off-chain message with their wallet. | CryptoSwift verifies the signature automatically. |
| Satoshi Test | Sends a specified small amount to your deposit address. | CryptoSwift monitors for a matching transaction. |
| Visual Proof | Uploads wallet screenshots or media. | Your team reviews the evidence. |
| Self-Declaration | Declares 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
| Need | Details |
|---|---|
| Launch a ready-to-use customer journey | Widget |
| Build your own customer UI | Custom API integration |
| Collect SoF/SoW or Selfie / Liveness evidence | Additional steps |
| Reuse eligible ownership evidence | Reusable verification |
| Help a customer whose wallet cannot connect for signing | Manual message signing |
| Check chain support | Supported blockchains |
| Check pricing | Credit usage |
Next steps
- Integrate the Widget
- Build a custom API integration
- Add Source of Funds / Wealth or Selfie checks
- Reuse previous wallet verifications