## Documentation Index

Fetch the complete documentation index at: [/llms.txt](https://docs.walletconnect.com/llms.txt)

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

---

The Headless SDK is a set of framework-agnostic [`@walletconnect/pay-*`](https://www.npmjs.com/org/walletconnect) packages that own the WalletConnect Pay payment flow while you own the UI. It’s the exact runtime that powers our own hosted Buyer Experience — extracted so you can build a fully branded, fully owned checkout on the same engine. You get the payment state machine, Engine API client, and wallet orchestration; you bring your own UI, branding, routing, and infrastructure.

**Beta (v0.1.x)** — The Headless SDK is under active development. Public APIs may change between minor releases until 1.0. [Talk to us](https://share.hsforms.com/1XsMCkUxFT2Cte8SCeAh89wnxw6s) before going to production.

## Who is it for?

- **Payment Service Providers & Acquirers** who want crypto checkout inside their own product, with their own design system and domain — not a redirect to a third-party page.
- **Platforms & marketplaces** embedding pay-with-crypto directly into an existing checkout flow.
- **Teams that need control** over every step of the UX: wallet selection, network/token choice, compliance prompts, success and error states.

If you just want to accept payments with the least effort, use the [hosted gateway](https://docs.walletconnect.com/payments/overview) or the [Ecommerce integration](https://docs.walletconnect.com/payments/ecommerce/overview) instead. Reach for the Headless SDK when you need to **own the experience**.

## What you get

## A headless payment runtime

The full payment state machine (load → connect → quote → sign → confirm → settle) as a framework-agnostic engine. No UI imposed.

## A typed Engine API client

A zero-dependency client for the WalletConnect Pay Engine, with the secret API key safely held server-side.

## A React binding

A single `usePaymentSession` hook that projects the runtime into a clean, serializable snapshot plus named actions — zero state-machine internals leak into your components.

## A wallet adapter

A ready-made adapter over [Reown AppKit](https://reown.com/appkit) for wallet connection across EVM and Solana — or bring your own.

## Supported networks & tokens

The Headless SDK supports the full WalletConnect Pay token and network coverage — USDC, USDT, EURC, PYUSD and more across Ethereum, Polygon, Base, Optimism, Arbitrum (and Solana, rolling out). See [Token & chain coverage](https://docs.walletconnect.com/payments/token-and-chain-coverage) for the live list.

## Full example

The fastest way to learn the SDK is to read the reference checkout it’s extracted from. Every snippet in these docs comes from it.

[**Reference example — headless-checkout (Next.js)** 
\
A complete, branded Next.js checkout built on the four packages.](https://github.com/WalletConnect/walletconnect-pay-examples/tree/main/gateway/headless-checkout)

## Next steps

[**How it works** 
\
The payment lifecycle, the host + seams model, and how the API key stays server-side.](https://docs.walletconnect.com/payments/psps/headless-sdk/how-it-works)

[**Implementation** 
\
Build a complete checkout in React / Next.js, step by step.](https://docs.walletconnect.com/payments/psps/headless-sdk/implementation)