HTML, Webflow, Ghost

Any website

Easy paywall: script tag + blur markers. Hard lock needs an origin adapter (nginx/Caddy/Apache/Next/PHP/WP) that emits an empty paywall mount until unlock. Bots get HTTP 402 on your domain via those adapters.

Before you start

Replace placeholder values like smid_YOUR_PROJECT_ID and https://yoursite.com with your project ID and site origin from the dashboard.

  • A smidgen.io project — copy your project ID from the dashboard
  • Add https://yoursite.com under Allowed websites in project settings
  • Create at least one paywall rule whose path and selector match your premium content
  • Set a payout wallet (Base or Solana) to receive USDC
  • API base URL: https://smidgen.io

Browser snippet

Easy: wallet checkout via snippet.js with data-x402-paywall. Hard lock: see the Hard lock tab.

nginx / adapter

HTTP 402 + x402 payment instructions for agents

Quick setup

Create a project in the smidgen dashboard, then follow these steps on your site.

  1. Add https://yoursite.com to Allowed websites in this project.
  2. Paste the script tag before </head> on every page.
  3. Gate premium blocks with data-x402-paywall="your-slug" (match paywall rules).
  4. For server-side enforcement on your domain, add nginx, Caddy, or Apache (see those integration guides).
  5. After payment the snippet sets an unlock cookie — adapters forward it to the smidgen gate.

Personalized snippets

Open a project in the dashboard for copy-paste configs with your real project ID, API URL, and allowed origin.