This guide walks through the complete AuthOnce merchant integration — from account creation to your first live USDC subscription on Base Network. The process takes under two hours for WooCommerce and PrestaShop merchants. No smart contract knowledge required.
AuthOnce is currently live on Base Sepolia testnet. All integrations built now will be compatible with Base Mainnet at Q3 2026 launch.
Before You Start
You need three things before beginning integration: a merchant USDC wallet on Base Network (Coinbase Wallet or any EVM-compatible wallet), your WooCommerce or PrestaShop store with admin access, and a basic understanding of how non-custodial subscription billing works. The integration itself requires no Solidity knowledge and no direct contract interaction.
Step-by-Step Integration
Create Your Merchant Account
Visit authonce.io and connect your USDC wallet. Your wallet address becomes your merchant identifier. Registration takes under five minutes. You will receive a vanity handle (e.g. pay.authonce.io/yourstore) immediately after registration.
Configure Your Subscription Plan
In the merchant dashboard, create a subscription plan with the following settings:
- Billing amount — fixed USDC amount per cycle (max $200 during pre-audit period)
- Billing cycle — monthly, quarterly, or annual
- Grace period — 1–30 days (recommended: 7–14 days for most use cases)
- Plan name — displayed to subscribers at checkout
Install the WooCommerce Plugin
Download the AuthOnce WooCommerce plugin from the merchant dashboard. Install via WooCommerce > Plugins > Add New > Upload. Activate the plugin and navigate to WooCommerce > Settings > AuthOnce. Enter your merchant wallet address and plan ID. Save settings. The plugin automatically adds the AuthOnce payment option to your checkout flow.
Test on Base Sepolia
Before activating for real subscribers, test the complete flow on Base Sepolia testnet. Use a test wallet with Sepolia USDC to simulate a subscriber authorization and first pull payment. Verify the subscription appears in your merchant dashboard. Verify the grace period triggers correctly on a simulated failed payment.
Activate and Go Live
Switch the plugin to Base Mainnet mode (Q3 2026 at protocol launch). Your existing test configuration carries over. Subscribers visiting your WooCommerce checkout will see the USDC subscription option. Their authorization uses an EIP-2612 permit — zero gas, no pre-approval transaction required. The first pull payment executes at the start of their first billing cycle.
The PrestaShop module follows the same five-step process. Download the module from your merchant dashboard. Install via PrestaShop > Modules > Module Manager > Upload a module. Configuration fields are identical to the WooCommerce plugin.
Managing Active Subscriptions
The merchant dashboard shows all active, grace period, and suspended subscriptions in real time. Every subscription state change is recorded on Base Network and visible in the dashboard with the corresponding transaction hash. You can configure email notifications for failed payments, grace period initiations, and successful retries.
For a full explanation of the four subscription states (Active, Grace, Suspended, Cancelled), see our article on programmable grace periods.
Subscriber Experience
From the subscriber's perspective, the process is: connect wallet at checkout, sign the EIP-2612 permit (one signature, zero gas), receive subscription confirmation. No further action is required unless they want to cancel — which they can do unilaterally by revoking the permit from their wallet, without contacting the merchant.
Subscribers with insufficient USDC on billing day enter the grace period automatically. They receive an on-chain notification and retain access while the protocol retries. Most subscribers top up and continue without noticing any disruption.
Vanity Pay Links
Every AuthOnce merchant receives a branded pay link at pay.authonce.io/yourhandle. This page works as a standalone payment interface outside your WooCommerce store — useful for direct billing via email, social channels, or partner integrations. The pay link uses the same protocol and the same grace period configuration as your store integration.
Ready to integrate?
AuthOnce is live on Base Sepolia. Mainnet Q3 2026. Start building your integration now so you're ready at launch.