Quick Start
Subscriptions let you charge customers automatically on a recurring basis (monthly, quarterly, or yearly). Instead of one-time payments, customers subscribe to a plan and their wallet is automatically charged at each billing interval.
💡 Subscriptions run on smart contracts on the Base blockchain. Once a customer subscribes, the blockchain automatically handles billing - no manual invoicing needed.
How it works:
You create a subscription plan (e.g., "Premium - $29.99/month")
You share a link with customers
Customer clicks link, approves the subscription, and pays first month
Every 30 days, smart contract automatically charges their wallet
You receive USDC directly to your wallet - no middleman
Creating a Subscription Plan
1 Go to Subscriptions Page
In the merchant dashboard, click "Subscriptions" in the sidebar, then click "+ Create New Plan"
2 Set Plan Details
Fill in the following fields:
Plan Name (required)
Description (optional)
Amount (required)Price in USDC. Can use decimals (e.g., 29.99)29.99
Billing Interval (required)How often to charge customers
Monthly (30 days) - Customer charged every 30 days
Quarterly (90 days) - Customer charged every 90 days
Yearly (365 days) - Customer charged every 365 days
Features (optional)
Click "Create Plan"
Your plan is created instantly and set to ACTIVE status. It's now ready to accept subscribers.
⚠️ Important:Once created, the plan price is locked for existing subscribers. If you change the price later, only NEW subscribers get the new price. Existing subscribers keep their original rate.
Sharing Your Subscription Plan
After creating a plan, you need to share it with customers.
1 Get the Subscription Link
On your Plans page, find your plan card and click the link icon (🔗). The subscription link is copied to your clipboard.
https://pay.onlystables.ai/subscribe/plan_abc123xyz2
Share the Link
Send this link to customers via:
Email campaigns
Social media posts
Website pricing page
Discord/Telegram announcements
Newsletter
💡 What Customers See:When customers click your link, they see a subscribe page showing your plan name, description, price, billing frequency, and all features. They can subscribe with one click.
What Happens When Someone Subscribes
Here's the exact flow when a customer subscribes to your plan:
1 Customer Clicks Subscribe Link
They land on the subscription page showing your plan details.
2 Customer Connects Wallet
They click "Subscribe Now" and connect their wallet (MetaMask, Coinbase Wallet, or email login). They need USDC in their wallet to subscribe.
3 Customer Approves Subscription
Two transactions happen:
Transaction 1: Approve - Customer approves the smart contract to charge them recurring payments
Transaction 2: First Payment - First payment is immediately sent to your wallet
4 Subscription is Active
Customer is now subscribed! Their status is set to ACTIVE and they appear in your Subscribers list.
✅ You Get Paid Instantly: The first payment goes directly to your wallet on-chain. No waiting period, no payment processor holding your funds. It's in your wallet immediately.
How Recurring Payments Work
After the first payment, the smart contract handles all future payments automatically.
1 Automatic Billing
Every 30 days (or 90/365 depending on your interval), the smart contract automatically charges the customer's wallet.
2 Customer Doesn't Need to Do Anything
No clicking "pay now" buttons. No entering payment details. The blockchain handles it automatically - as long as they have USDC in their wallet.
3 You Receive Payment
Payment goes directly to your wallet. You see it in your Transactions page and your wallet balance updates.
⚠️ What if Customer Doesn't Have Enough USDC? If customer's wallet doesn't have enough USDC when billing runs, the payment fails. Their subscription status changes to PAST_DUE. The system retries automatically, but you should contact them to add funds.
Managing Your Subscribers
Viewing Subscribers
Go to Subscriptions → Subscribers tab to see everyone subscribed to your plans.
For each subscriber you see:
Customer info - Wallet address, email (if provided), name
Plan - Which plan they're on
Status - ACTIVE, PAUSED, CANCELLED, or PAST_DUE
Next payment - When they'll be charged next
Total paid - How much they've paid you lifetime
Payments made - Number of successful payments
Actions You Can Take
View payment history - See all payments this customer has made
Cancel subscription - End their subscription immediately
Contact customer - Click their email to send a message
Download invoice - Generate PDF invoice for their records
Cancelling Subscriptions
Customers Can Cancel
Customers can cancel their own subscription from the customer portal. When they cancel:
Status immediately changes to CANCELLED
No more automatic billing
They lose access to your service
No refunds (they paid for the current period already)
You Can Cancel Too
As a merchant, you can cancel any customer's subscription from the Subscribers page. Same rules apply - immediate cancellation, no refund.
⚠️ Cancellation is Final: Once cancelled, the subscription is gone. Customer would need to resubscribe (which creates a new subscription, not resume the old one).
Pausing Instead of Cancelling
Customers can also PAUSE their subscription instead of cancelling. This is better because:
No billing while paused
They can resume anytime
They keep their price locked in
Lower churn for you
How You Get Paid
This is the best part - getting paid is automatic and instant.
1 Payment Goes to Your Wallet
Every subscription payment is sent directly to the wallet you used to login. It's on-chain, so you can see it in your wallet (MetaMask, Coinbase Wallet, etc.) immediately.
2 No Holding Period
Unlike Stripe or PayPal that hold funds for days, your money is available instantly. It's your USDC in your wallet right away.
3 Track in Dashboard
Your Subscriptions page shows total revenue, and the Transactions page lists every payment. You can see who paid, when, and how much.
Last updated