Skip to content

Deployment

Prepare native gateway, Worker gateway, and this documentation site for production.

The gateway and documentation site are separate deployable surfaces. This site is configured for Cloudflare edge SSR at x402.pwp.sh.

Documentation site

Shell
pnpm --filter @x402-paysdk/docs typecheckpnpm --filter @x402-paysdk/docs build:edgepnpm --filter @x402-paysdk/docs deploy

The deployment command uses docs/wrangler.jsonc and targets the x402.pwp.sh custom domain. Authenticate Wrangler locally before deploying. No resource IDs or secrets are committed.

Gateway selection

Use gateway-native when you need the complete self-hosted route surface or control over process, database, and networking. Use gateway-worker when you want edge execution and have configured the required D1/KV bindings and production gates.

Preflight checklist

  1. Set the canonical gateway origin and HTTPS termination.
  2. Configure facilitator and bounded RPC endpoints.
  3. Provision the signing key, secret pepper, merchant secret storage, and rate limits.
  4. Apply D1 migrations before enabling Worker-backed stores.
  5. Exercise negotiation, settlement, receipt verification, and recovery.
  6. Confirm logs contain no credentials or replayable payment payloads.
  7. Reconcile against chain history before enabling irreversible fulfillment.