WalletConnect Pay — Headless SDK Integration

What this is

WalletConnect Pay lets an app accept stablecoin payments from any WalletConnect-compatible wallet. The Headless SDK is the set of framework-agnostic npm packages (@walletconnect/pay-*) that run the payment flow — loading the payment, connecting a wallet, quoting, signing, and settling — without imposing any UI. You render the screens; the SDK runs the machine.

It is the same runtime that powers WalletConnect's own hosted checkout ("Buyer Experience"), extracted so you can build a fully branded checkout on the same engine.

This skill teaches the SDK contract, not a prescribed app structure. The code here shows how to call the SDK correctly. How you route requests, lay out files, and structure your UI is yours — treat the example scaffolding as one illustration, not a required shape. For a complete, opinionated build, see the reference example and the official docs.

When to use

• Building a self-hosted, branded stablecoin checkout inside your own product and domain
• Embedding pay-with-crypto into an existing checkout flow instead of redirecting to a WalletConnect-hosted page
• Wiring the server proxy that keeps the Engine API key off the browser
• Rendering the payment lifecycle (load → connect → quote → sign → confirm → settle) from a snapshot
• Troubleshooting the four SDK packages (see The four packages below)

Not this skill: if you only want to create a payment request (a link/QR) or poll its status as a merchant, or you're adding WC Pay acceptance to a wallet app, this is the wrong integration — those are separate products. If you just want the fastest path with no UI to build, use WalletConnect's hosted gateway instead.