Skip to Content
Platform.Ontology

In-app purchase (StoreKit 2, Play Billing)

Sells digital goods and subscriptions through the platform store.

Works without askingPayments and shoppingApp store billingAndroid and iPhoneWhile you use itWhen you are signed in

In one line

Can sell digital items and subscriptions, after you approve each purchase

Sells digital goods and subscriptions through the platform store.

The platform handles payment, receipts and refunds, and takes a commission. The store knows who buys what in every app.

What it can and can't do

What the user does: You tap Buy or Subscribe and confirm with Face ID, a fingerprint or a passcode

It can

  • Charge you through the App Store or Google Play after you confirm
  • Offer subscriptions that renew until you cancel
  • Issue refunds through the store tools on iPhone

It cannot

  • Charge you without a purchase sheet and your confirmation
  • Skip the store's fee, which is 15 or 30 percent in most cases
  • Cancel your subscription for you; that happens in your store account

How it differs between platforms: iPhone uses StoreKit and Face ID. Android uses Play Billing and a Google Play purchase sheet. Store fees are 15 or 30 percent.

On Android and iPhone

AndroidiPhone
StatusSupportedSupported
First versionAndroid 4.0 (API 14)iOS 15.0
Permission or entitlementcom.android.vending.BILLING (normal)com.apple.developer.in-app-purchase capability
Protection levelnormalentitlement
How access is grantedinstallprompt
What the user seesGoogle Play purchase sheet with authApp Store purchase sheet with Face ID
How long it lastsEntitlements verified by serverVerified through signed transactions (JWS)
How to take it backPlay Store > SubscriptionsSettings > Apple ID > Subscriptions
Store policyPlay: digital goods must use Play Billing unless a program allows alternatives; PBL 7 or 8 required for new releasesApp Review 3.1.1
APIGoogle Play Billing Library 7 and 8, ProductDetails, BillingClientStoreKit 2 Product, Transaction, AppTransaction (iOS 16); StoreKit Messages
NotesFee 15 percent for first million dollars and subscriptions after year one; 30 percent standard. Epic settlement changes pending.Small Business Program 15 percent; App Store Server API for refunds.

Data you get

What comes back: Signed transaction
Shape: object
How often: per purchase

FieldTypeUnitRangePrecision
pricefloatcurrencyvariesexact
expirationstringISO datevariesexact

Technical limits

  • Apple 3.1.1 and Play rule: digital goods need store billing except where law or programs allow external options
  • Store holds card data, not the app

The story

What it is

The store's built in way to sell subscriptions and digital goods inside an app.

For you

You tap Subscribe and a store sheet asks for Face ID or a fingerprint. The charge goes on your account and you can manage or cancel it in settings.

For makers

Makers get payments, receipts and refunds handled for them. The store keeps a commission, usually 15 to 30 percent, and knows who buys what in every app.

Where you see it

TypeExampleApps
gamesA game sells gems and a battle pass with one tap.Fortnite, Candy Crush
mediaA streaming app sells a monthly plan.Netflix, Spotify
productivityA notes app unlocks pro features once.Bear
datingA dating app sells boosts and premium.Tinder
educationA language app sells a yearly plan.Duolingo
securityA fraud team checks receipts to stop fake purchases.None named
adsA growth team measures which ad led to a first purchase.None named

Risks

  • Dark pattern upsells
  • Fake receipts and fraud

Android and iPhone in short

  • Android: Google takes 15 percent on the first million dollars and on subscriptions after year one. 30 percent is standard.
  • iPhone: Apple's Small Business Program lowers the fee to 15 percent. Purchases use Face ID.

What the platform says

  • Apple: In-App Purchase. Apple pitches In-App Purchase as a simple, secure way to sell digital goods and subscriptions in apps.
  • Google: Google Play Billing. Google describes Play Billing as the system for selling digital products and subscriptions in apps.

Good uses and abuse

Legitimate uses

  • Subscriptions
  • Game currency

Known abuse

  • Dark patterns
  • Fraud with fake receipts

Scores

ScoreValueMeaning
Sensitivity4 of 5How revealing the data is
Utility5 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bits1Rough identifying entropy, when known

A real example: LinkedIn

Premium and Learning subscriptions are sold in app. Apple label lists Purchase History and Other Financial Info as Linked to You; Play lists purchase history and other financial info (optional).

History

  • 2021-06, iPhone iOS 15: StoreKit 2
  • 2022-03, Android n/a: Play Billing Library 5 and later changes to subscriptions
  • 2022-04, Android Play Billing 5: Subscription offer model update
  • 2024-08, Android PBL 7: Required for new apps on Play from Aug 2025

Same idea on the web

Sources

How well checked: Checked against real behavior.

On this page