Overview
The WalletConnect POS SDK brings the simplicity of “tap-to-pay” to crypto. Using a QR-based flow, any wallet connected through WalletConnect can make real-world payments in seconds.- Merchant: Selects “Crypto Payment” → POS generates a payment QR
- Customer: Scans with their wallet → confirms transaction
- POS: Receives instant onchain confirmation and marks payment complete
Quickstart
Why WalletConnect POS SDK?
Stablecoins have become the dominant onchain payment medium with $4T+ monthly transaction volume, yet real-world checkout remains fragmented:- Merchants must integrate multiple wallets or blockchains individually
- PSPs lack visibility into transaction states and reconciliation
- Customers face confusing UX with manual address entry and gas settings
What does WalletConnect POS SDK have to offer?
Universal Rail
A single SDK for PSPs and merchants to accept stablecoin payments across any WalletConnect-compatible wallet and supported network. No separate wallet integrations or new hardware required.
Seamless Checkout UX
Customers simply scan, confirm, and pay. Payments settle onchain in seconds with a familiar checkout experience similar to Apple Pay or tap-to-pay.
Multi-Chain with Full Visibility
Supports EVM, Solana, and Tron from day one. Provides standardized transaction statuses for reconciliation and customer support:
[new, pending_onchain, confirmed, underpaid, overpaid, expired, failed].How does it work?
Merchant - Point of Sale (POS)
- Selects Crypto as payment method.
- Chooses token (e.g., USDC, USDT).
- Chooses network (e.g., Base, Polygon, Ethereum).
- POS generates QR with payment details (amount, token, network, destination).
Customer (Wallet)
- Scans the QR using a WalletConnect-compatible wallet.
- Wallet displays payment preview.
- Customer confirms the transaction.
- Transaction broadcasts onchain.
Completion
- POS receives confirmation and displays success/receipt
- Transaction hash available for tracking and reconciliation
Who is it for?
Payment Service Providers & POS Integrators
DTC Pay, Square-like or Ingenico-style providers are examples of PSPs that can use the POS SDK to accept stablecoin payments.- Reduce cost and complexity of integrating stablecoin payments
- Gain transaction lifecycle visibility for refunds and reconciliation
- Stay competitive as stablecoin adoption enters mainstream retail
WalletConnect POS SDK does not handle refunds or reconciliation directly. It is the responsibility of the PSP to handle these. However, the SDK provides the necessary standardized callbacks to allow the PSP to handle the refund and reconciliation process.
Merchants
- Accept stablecoins from any wallet with no new hardware
- Offer customers a fast, modern checkout experience
- Maintain compliance and reporting via PSP dashboards
Supported Environments
| Category | Support |
|---|---|
| POS SDKs | Flutter, Kotlin, JavaScript |
| Assets | Stablecoins (e.g., USDC, USDT) |
| Networks at Launch | EVM chains (Ethereum, Optimism, Base, etc.), Solana, Tron |
| Wallet Coverage | 500+ WalletConnect-compatible wallets |
| Transaction Lifecycle | Standardized callbacks -> PaymentSuccessfulEvent, PaymentFailedEvent |