FAQ

What is x402?

HTTP 402 "Payment Required" protocol implemented by facilitators who handle transaction fees.

Why does facilitator pay fees?

Better UX - users don't need extra SOL for gas. Creates seamless payment experience.

What tokens are supported?

SOL, USDC, USDT on Solana mainnet and devnet.

How fast are payments?

~3-6 seconds total (800ms blockchain settlement, rest is user interaction).

Is this production-ready?

Yes, handles real mainnet transactions.

Do I need an API key?

No - facilitator is public. YOU implement auth for YOUR API.

How do I verify payments?

Use /verify endpoint or check blockchain directly.

What about refunds?

Qwery uses replay protection, rate limits, hashed secrets, Cloudflare WAF, and on-chain verification for every transaction. No user funds are ever held custodially.

Can I run my own facilitator?

Yes! Code is open source.

What's the fee structure?

Facilitator pays network fees (~$0.0005-0.001 per tx). No additional fees.

How do I test?

Use solana-devnet network, get free devnet SOL from faucet.

What wallets work?

Any Solana wallet (Phantom, Solflare, Backpack, etc).

How secure is this?

Facilitator never holds user funds, only co-signs transactions.

Can I accept payments without SDK?

Yes, call REST API directly. SDKs just make it easier.

What happens if facilitator is down?

Payments fail gracefully. Run your own facilitator for redundancy.