Two ways to integrate
Hosted gateway
Send buyers to
pay.walletconnect.com and let WalletConnect Pay handle the whole experience — wallet selection, quoting, signing, and settlement. The fastest path to accepting payments, with no UI to build.Headless SDK
Build a fully branded, fully owned checkout inside your own product. You get the payment runtime, Engine client, and wallet orchestration as framework-agnostic packages; you bring the UI, branding, and domain.
Which one is for me?
Reach for the hosted gateway if you want to accept payments with the least effort and are happy to send buyers to a WalletConnect-hosted page. See the hosted gateway overview or the Ecommerce integration. Reach for the Headless SDK when you need to own the experience end to end — wallet selection, network and token choice, compliance prompts, success and error states — all inside your own design system and domain, with no redirect to a third-party page.Both paths run on the same WalletConnect Pay Engine and share the same token and network coverage. You can start with the hosted gateway and move to the Headless SDK later without re-doing your backend integration.
Who is it for?
- Payment Service Providers & Acquirers offering crypto checkout inside their own product, with their own design system and domain.
- Platforms & marketplaces embedding pay-with-crypto directly into an existing checkout flow.
- Teams that need control over every step of the UX.
Next steps
Headless SDK
Own the full checkout experience with the
@walletconnect/pay-* packages.API Reference
The Gateway and Payments endpoints behind WalletConnect Pay.
Talk to us about PSP integration
Are you a PSP or acquirer? Tell us what you’re building and we’ll help you get set up.