About this plugin
P2Flux settles payments from the customer’s wallet to yours in a single on-chain transaction. There
is no account to open, no balance to withdraw and no third party holding your revenue: the money
never sits anywhere on its way to you.
Subscriptions work the same way. The customer signs one authorization in their wallet, and after
that the store decides when a renewal is due and this plugin collects it. The customer’s wallet is
never asked again, and the amount, the wallet it pays and the billing period are fixed by what they
signed – a merchant cannot change them afterwards, which is the point.
Native Simple Subscriptions
Simple recurring products can use P2Flux Native Subscriptions without any separate subscription
extension: WooCommerce plus this plugin is enough. Tick “P2Flux recurring subscription” on an
ordinary simple product, choose daily, weekly, monthly or yearly, and the product’s price becomes
the recurring amount. The plugin creates a renewal order each period, collects it, and shows the
subscription under My Account → USDC subscriptions and WooCommerce → P2Flux Subscriptions.
Native v1 supports fixed-price, non-taxable virtual subscription products, priced in US dollars,
bought one at a time and on their own. Taxes, coupons, shipping, free trials, sign-up fees and
variable subscriptions are not supported in native mode. Native subscription products are paid
through P2Flux only; other WooCommerce gateways cannot be used for them. Normal WooCommerce
products continue to use your existing payment gateways – the P2Flux-only requirement applies only
to products using P2Flux Native Subscriptions.
If you already run WooCommerce Subscriptions, it keeps working as before and the two coexist; a
product belongs to one of them, never both.
What you need
- A wallet address on Base that you control. Payments arrive there directly.
- Prices in USD for subscriptions. One-time payments work in any currency the plugin can convert.
- For advanced subscription features (trials, sign-up fees, variable subscriptions, switching),
WooCommerce Subscriptions. Simple fixed subscriptions need nothing extra.
Fees
10 USDC network fee on a recurring
charge. On a renewal the gas is reimbursed out of the charge, capped by what the customer signed.
A one-time payment’s network fee is paid one of two ways. With “No-ETH checkout” on, the customer
10 USDC
70 USDC. The
customer can still choose to pay the network fee in ETH themselves, and then you receive the price
less 1%, as with “No-ETH checkout” off.
Test it first
The plugin ships with a test mode that settles on Base Sepolia. It behaves exactly like the live
one – same contracts, same signatures, same failure modes – with faucet money instead of real USDC.
Orders keep the environment they were created in, so switching to live later never disturbs them.
External services
This plugin sends data to two external services. A third (Hinkal) is involved only if you switch on private payments, and only through P2Flux’s payment page, never from your store.
com, and the hosted checkout at
com)
Used to create payment instructions, to verify payments against the Base blockchain, and to collect
subscription renewals. Sent: your payout wallet address, the amount in USDC, the billing period for
a subscription, and transaction hashes for verification. Your customers’ browsers open the hosted
checkout window, which sees only the amount, the recipient and the network – never the product, the
customer or the order.
html. html.
com/v2/exchange-rates)
Used only when your store’s currency is not USD, to convert a price into USDC. Sent: nothing but the
request itself; the response is cached for an hour. No order, customer or store data is included.
com/legal/developer-platform/terms-of-service. Privacy policy:
com/legal/privacy.
io) – only if you switch on “Private payments”
The plugin itself never contacts Hinkal: it only asks P2Flux to offer “Pay privately with Hinkal” on
the hosted checkout. A customer who chooses it is taken to P2Flux’s private payment page
com), which connects their wallet to Hinkal to pay from their Hinkal
private balance. Your store sends Hinkal nothing.
io/tos. io/privacy-policy.
Privacy
The plugin stores no name, address, email, wallet address, IP address or user agent of its own;
those stay in WooCommerce’s customer and order records and follow WooCommerce’s own personal-data
export and erasure. What the plugin stores is the financial history of each payment and
subscription: amounts, billing periods, public blockchain identifiers (an authorization id and
transaction hashes), the store’s own payout wallet, and – for subscriptions – the customer’s
recurring authorization, encrypted, which the store needs to refund a payment and the customer to
revoke it. Native subscriptions live in a table of their own, linked to the customer account by id.
Personal-data requests: the plugin registers an exporter (what each subscription record says) and
an eraser. Erasure unlinks the subscription from the customer, cancels it so a wallet whose owner
the store no longer knows is never charged, and keeps the financial rows; deleting the customer’s
WordPress account does the same. Financial records are retained because a payment that happened on a
public blockchain is not made private by deleting the store’s only record of it, and the encrypted
authorization is what still allows a refund. Uninstalling keeps them too unless the store opts into
destructive removal.
Documentation
The full guide – installation, every renewal outcome, cancellation, refunds, recovery,
html. Developer documentation and the
com/P2Flux/woocommerce.