Skip to content

Hands-on seller lab

Goal: Complete all 6 go-live steps on preview.ipay.sh.

This lab uses preview.ipay.sh + Solana Devnet + Devnet USDC. Production later uses ipay.sh + Solana Mainnet + real USDC.

Start here: x402-seller-lab-express — not x402-seller-starter (Rust; same idea, different repo).

Full steps: repo README.md.


Lab ↔ preview.ipay.sh

preview.ipay.shREADME section
1 — API returns 402A → B → C
2 — Preview vaultSkip
3Activate (self-provision)D
4 — Register shopD
5 — Add APID
6 — Verify 402automatic

Done when step 6 passes and you appear in #directory.

Why Activate (step 3)?

One wallet signature (~0.1 SOL) creates your on-chain payment vault before the first sale.

  • You: pr402 Facilitator charges 90 bps protocol fee (sovereign) vs 100 bps if you skip and wait for JIT provision on first payment
  • pr402: no vault-creation cost bundled into a buyer's first settle

Self-provision is the win-win path pr402 is designed around.


Quick path

A — Phantom or Solflare browser extension → Devnet + SOL (faucet)

Bnpm install.envenrich + devverify-402 localhost → PASS

C — deploy to public https (any host; Vercel example in repo) → enrich again → verify-402 live → PASS

Dpreview.ipay.sh: Activate → Register → resources → wait for step 6

E — copy 3 files into your real project (repo README)

Integrate your API · Fees

Built for the autonomous future.