WalletConnect Pay - WalletConnect Pay Docs

Documentation Index

Fetch the complete documentation index at: /llms.txt

Use this file to discover all available pages before exploring further.

Digital payments across blockchains remain inconsistent. Payments are fragmented by geography and Rail. For example, a few countries in Latin America run on PIX and Mercado Pago, Europe on SEPA and cards, Southeast Asia on QR wallets like GrabPay and GCash, China on Alipay and WeChat Pay, India on UPI. Each region invented its own system, none of them interoperate, and merchants and PSPs are forced to support whatever their local stack dictates. Users adapt to the rail in front of them rather than the method they prefer. In the world of Crypto payments, each wallet, merchant, and provider implements its own integration model. This fragmentation slows innovation and limits interoperability. To address this, WalletConnect introduces the WalletConnect Pay. WalletConnect Pay provides a complete end-to-end crypto payment solution that fits directly into an existing Payment Service Provider (PSP) stack, allowing crypto payments to be offered without changing how payments operate today. It also aligns with common payment compliance requirements, such as required customer and transaction information capture and screening steps, so providers can keep the same operational and compliance controls they rely on today.

Who is WalletConnect Pay for?

There are a couple of primary actors that can benefit from WalletConnect Pay:

• Payment Service Providers (PSPs) and Acquirers - PSPs and Acquirers can integrate WalletConnect Pay into their existing payment stack, allowing them to offer their merchants and customers an option to accept crypto payments without changing how payments operate today.
• Merchants - PSPs and Acquirers can offer their merchants an option to accept crypto payments without changing how payments operate today.
• Wallets - Wallets can work closely with WalletConnect to provide a seamless payment experience for their users by integrating the WalletConnect Pay SDK into their wallet.

What would WalletConnect Pay look like in action?

1. The merchant presents a WalletConnect QR code with the payment intent.
2. The customer scans the QR with their wallet:
   • The wallet displays the payment intent.
   • The customer picks the token and network of their choice (e.g., USDC on Ethereum) and approves the payment.
   • The wallet builds the transaction and sends it to the network.
3. Or alternatively, the customer scans the QR code with their QR scanner:
   • This takes the customer to a payment gateway URL that is pre-filled with the payment intent.
   • The customer can connect their wallet (using WalletConnect).
   • The wallet displays the payment intent.
   • The customer picks the token and network of their choice (e.g., USDC on Ethereum) and approves the payment.
   • The wallet builds the transaction and sends it to the network.
4. The merchant receives the transaction result and the customer is notified.
5. The merchant then receives fiat or crypto settlement from the PSP.

What does WalletConnect Pay offer?

• Any wallet can be used across checkout types.
• Buyers can pay from any wallet at online checkout and in-person.
• Payments are only confirmed when they can be completed:
  • Balance checks, routing, and compliance (screening, KYC/KYT) are completed before a payment is confirmed.
• Funds move and settle predictably:
  • Fixed, transparent fees, consistent settlement paths (crypto or fiat), in-flow swaps and bridges, and more.
• Everything is logged and observable:
  • Full audit trails and data visibility for operations, support, and reporting.
• Merchants get clear onboarding materials and familiar tools:
  • Clear documentation, reference implementations, and operational dashboards aligned with traditional payment workflows.

What else does WalletConnect Pay offer?

WalletConnect Pay is designed to fit into existing checkout workflows so crypto payments can feel like a natural extension of how payments already run today. WalletConnect Pay is also available as a compliant e-commerce (checkout) solution.

Get Started

Every integration can be built and verified end to end in test mode — same API, no real funds — before going live.