Primer Pay – WordPress plugin | WordPress.org
Skip to content
Get WordPress
WordPress.org
Plugin Directory
Primer Pay
Search plugins
Details
Reviews
Installation
Development
Support
Description
Primer Pay lets you put any post or page behind a micropayment wall using the x402 protocol. Visitors with the Primer Pay browser extension pay seamlessly and see your content instantly. No user accounts, no subscriptions, no payment forms.
How it works:
You enter your wallet address in Settings > Primer Pay.
You check "Enable x402 Paywall" on any post and set a price (e.g., $0.01 USDC).
Visitors with the Primer Pay Chrome extension pay automatically and see your content.
Visitors without the extension see a teaser and a prompt to install Primer Pay.
Payments settle on Base (Ethereum L2) via USDC — low fees, instant finality.
Features:
Gutenberg Content Gate block — visual divider between free teaser and paid content with inline settings
Classic editor support — [primer_pay_x402] shortcode plus sidebar meta box
Per-post price override (defaults to your site-wide price)
Per-post wallet override — route payments to a different wallet per post (multi-author support)
Multi-network: accept payments on Base, SKALE Base, or both — with configurable priority
Theme-matching paywall banner — inherits your site’s fonts, colors, and border radius
Configurable access duration: 30 minutes to "never expires"
.well-known/x402 discovery endpoint — JSON index for AI agents and crawlers to find purchasable content
Works with any theme that renders the_content() normally
No user accounts or login required
Non-custodial — payments go directly to your wallet
Requirements:
A wallet address on Base or SKALE Base (e.g., from MetaMask, Coinbase Wallet, or Primer Pay itself — same address works on all supported networks)
HTTPS recommended (cookies are marked Secure on HTTPS; HTTP still works for local dev)
External services
This plugin relies on the Primer x402 facilitator service to verify and settle payments. When a visitor attempts to pay for content, the plugin sends the signed payment authorization to the facilitator, which validates the signature and executes the on-chain USDC transfer on the Base network.
Service: Primer x402 Facilitator
Endpoint: https://x402.primer.systems/settle
When: Whenever a visitor submits a valid X-PAYMENT header to the plugin’s unlock endpoint
Data sent: The base64-encoded signed payment authorization (EIP-712 typed data) from the visitor, plus the payment requirements (amount, asset address, recipient wallet address, network). No personally identifiable information about the visitor is sent — the only identifier is the wallet address they signed with.
Terms of service: https://primer.systems
Privacy policy: https://primer.systems
This is the standard x402 protocol flow. If you prefer to run your own facilitator, you can configure a custom facilitator URL in the plugin settings.
Screenshots
Settings page — configure your wallet address, default price, access duration, and accepted networks.<br>Adding the Content Gate block — search for "Primer Pay" in the Gutenberg block inserter.<br>Content Gate in the editor — the block splits free teaser (above) from paid content (below), with per-post settings in the sidebar.<br>Front-end paywall banner — visitors without the extension see the price and a link to get started.
Blocks
This plugin provides 1 block.
Primer Pay Content Gate
Installation
From WordPress.org (recommended):
In your WordPress admin, go to Plugins > Add New.
Search for "Primer Pay".
Click Install Now, then Activate.
Manual upload:
Download the plugin zip file.
In your WordPress admin, go to Plugins > Add New > Upload Plugin.
Select the zip file and click Install Now, then Activate.
Setup:
Go to Settings > Primer Pay and enter your wallet address.
Edit any post, check "Enable x402 Paywall" in the Primer Pay sidebar box, and publish.
FAQ
What is x402?
x402 is a protocol for web payments using HTTP status code 402 (Payment Required). When a server returns 402, the Primer Pay browser extension automatically handles the payment and retries the request.
Do my visitors need crypto?
Visitors need the Primer Pay browser extension with a small USDC balance. The extension manages a simple wallet — no MetaMask or crypto experience required.
What are the fees?
Primer does not charge fees. Base network gas fees are typically less than $0.001 per transaction.
What happens if a visitor doesn’t have the extension?
They see a free teaser of your content plus a styled banner explaining the price and linking to the Primer Pay extension.
Is this custodial?
No. Payments go directly from the visitor’s extension wallet to your wallet address. Primer never holds funds.
Reviews
Primer pay is an innovative and niche plugin with a compelling concept – micropayments without subscriptions. Perfect for true pay per content and no personal data collection. Definitely...