Apps that take money on mobile go through the App Store and Google Play. Apple and Google take 15-30%, but in return they handle the checkout sheet, the receipts, the refunds, the tax, the fraud, the chargebacks, and the parental controls. Runable wires it all up so you describe what you want to sell and the agent builds the paywall, the products, and the after-purchase flow.Documentation Index
Fetch the complete documentation index at: https://docs.runable.com/llms.txt
Use this file to discover all available pages before exploring further.
What you can charge for
Subscriptions
Monthly, yearly, or custom periods. Free trials, intro pricing, and offer codes built in. Auto-renew with the user’s saved payment method.
One-time purchases
Pay once, own forever. Examples: unlock the full app, buy a single theme, remove ads.
Consumables
Buy and use up. Coins, credits, in-app currency. Stackable across purchases.
Free trials and intro offers
7-day or 30-day free trials, $1 first month, three-month discounted intro. Configured per region.
How a paid app comes together
Add payments to your app
Describe what you want to sell
Add a Pro plan: 19.99/year, with a 7-day free trial. Pro unlocks the History tab, custom themes, and unlimited habits. Show the paywall whenever a free user taps a locked feature.The agent designs the paywall screen, wires up the entitlement check, and writes the upgrade prompts in the right places.
Create the products on Apple's side
Open App Store Connect → My Apps → your app → Subscriptions (or In-App Purchases) and create the products the agent listed. For each one:
- Product ID (the agent gives you the exact string to use, for example
cairn_pro_monthly) - Reference name (internal only)
- Subscription group (Apple requires this the agent picks a sensible name)
- Price tier (Apple’s localized pricing matrix; the agent suggests one based on your prompt)
- Localized name and description for each region you support
Create the products on Google's side
Open Play Console → your app → Monetize → Products → Subscriptions (or In-app products) and create the same products with matching IDs. Google’s structure is slightly different each subscription has one or more base plans and offers (for free trials and intro pricing).The agent generates a printable mapping: which Apple product ID corresponds to which Play product ID, base plan, and offer. Use the mapping while filling in both consoles.
Test purchases on a real device
Real in-app purchases cannot be tested in the Expo Go preview. The agent runs a preview build for you, installs it on your phone via TestFlight (iOS) or Play internal testing (Android), and walks you through:
- Apple: creating a sandbox tester account in App Store Connect and signing in on your device
- Google: adding your Google account as a license tester in Play Console and opting into the internal testing track
What the paywall looks like
The agent generates a paywall that matches your brand. The default layout is the most common pattern Apple and Google approve:- Header: the value proposition in one line
- Feature list: three to five bullets of what unlocks
- Plan selector: a row of cards for each plan (monthly / yearly / lifetime), with the recommended plan highlighted
- CTA button: “Start free trial” or “Continue” depending on the offer
- Footer links: Restore Purchases, Terms, Privacy
- Trust line: “Cancel anytime in Settings”
Free trials and intro offers
Both stores let you offer reduced-price entry points. The agent supports all common variants:| Offer type | What it does | Use it for |
|---|---|---|
| 7-day free trial | Charge nothing for 7 days, then full price | Most consumer subscription apps |
| 30-day free trial | Charge nothing for 30 days, then full price | Longer-consideration purchases |
| Intro $1 month | Charge $1 for the first month, then full price | Lower trial commitment than free |
| 3-month intro 50% off | Charge half-price for 3 months | Re-engagement after trial ends |
| Win-back offer | One-time intro for users whose subscription lapsed | Lapsed subscribers |
Restore purchases
Every paid app needs a Restore Purchases button. Required by Apple. The agent puts it on the paywall and in Settings by default. When a user reinstalls or switches devices, tapping Restore reads their purchase history from the store and re-grants access no support ticket, no password.Family sharing
Apple lets a paid app share access across up to six family members on one purchase. You opt-in per product. The agent enables family sharing by default for one-time purchases; subscriptions are off by default (most consumer subscription apps choose not to share each member benefits from their own account). Change either with one line: enable family sharing on the yearly plan, keep it off on monthly.Refunds and chargebacks
Both stores handle refunds. Users request a refund through Apple or Google directly you do not process them. When a refund happens, your back end gets a webhook from the store and revokes access automatically. The agent wires this up; you do not have to write a single line. For consumables, you can choose what to do on refund:- Take back the consumable (recommended; the agent’s default)
- Let the user keep what they already used (kinder, but exploitable)
Stripe Checkout for web payments
Not everything on a mobile app has to go through the App Store. Apple and Google allow you to charge through external web payment processors for goods and services consumed outside the app (delivery, hardware, real-world events, accounting subscriptions, etc.). For these, the agent opens a Stripe Checkout in an in-app browser.This is allowed only for “physical goods or services consumed outside the app.” Digital subscriptions and in-app features have to go through the App Store and Play Store. The agent flags it if a prompt would cross the line.
What you can see
The project dashboard surfaces, per product:- Active subscribers today and over time
- Free trial conversion rate
- Monthly recurring revenue and yearly equivalent
- Churn rate by cohort
- Refunds as a percentage of revenue
- Lifetime value per user
What you cannot do
- Charge a credit card directly from a mobile app for in-app digital goods. Apple and Google require all digital purchases to go through their billing systems on their platforms.
- Hide the Restore Purchases button. Required by Apple.
- Sell adult content, weapons, or anything else against the store guidelines. No tool gets around this it is a policy line, not a technical one.
- Charge less in your app than on your website to incentivize web purchases on Apple. Apple allows you to mention web pricing in some categories (reader apps, music services in certain regions) but the rules are restrictive. Ask the agent to flag whether your app qualifies.
Next steps
Push Notifications
Send win-back pushes to lapsed subscribers and renewal reminders.
Analytics
Track conversion, trial-to-paid, churn, and revenue.
Deploy to App Store & Play Store
Set up store credentials, ship a build, and start selling.
Over-the-air Updates
A/B test paywall copy and pricing copy without a store review.