Callbook docs
v1.0.0
Get help
● Set up

Store products
lifetime and yearly Pro.

The app sells two things: a one-time lifetime Pro and a yearly subscription. You create them in App Store Connect and Google Play, then give the app their ids.

lifetimeyearlyrestore

01What Pro unlocks

A basic-tier user can seal a limited number of receipts a month and keep a limited number of sources (both numbers are console settings; the defaults are 10 and 3). Pro removes both limits and adds per-source records, CSV export and sharing a receipt as an image (each of these can also be switched off for everyone in the console). Sealed receipts stay readable and scored either way: only sealing new ones is limited. The paywall offers lifetime, yearly and Restore purchases.

Nothing ships pre-set

No product ids are included, and there are no fallback ids. With empty ids the paywall says purchases are not set up yet and Pro cannot be unlocked: it never fakes a purchase. If you do not want to sell Pro, set the paywall switch to off in the console (App config: paywall) and everything is unlocked.

Paywall screen
Paywall · sample data

02App Store Connect

  1. Create the app record with your bundle id (My Apps, plus).
  2. Open the app, then Monetization. Create a non-consumable in-app purchase for the lifetime product. Choose a product id such as pro_lifetime (you choose it; it cannot be reused later).
  3. Create a subscription group and an auto-renewable yearly subscription in it, for example pro_yearly.
  4. Set prices, names and the review screenshot for each, and accept the Paid Apps agreement and banking/tax forms. Products stay unavailable until these are done.
  5. Add the product ids to the app (below).
  6. Test with a Sandbox tester account on a real iPhone before you submit.

03Google Play Console

  1. Create the app with your application id, and upload a first build to an internal test track (Play only lets you create products once a build with the billing permission is uploaded).
  2. Monetize, Products, In-app products: create the lifetime product (one-time) with an id such as pro_lifetime.
  3. Monetize, Subscriptions: create the yearly subscription with a base plan billed yearly, id such as pro_yearly, and activate the base plan.
  4. Set up a merchant (payments) profile if Play asks for one.
  5. Add testers (Settings, License testing) and test from the internal track.

Google refunds purchases that are not acknowledged within three days, so test one purchase end to end.

04Where to put the ids

WayHow
In the console (no new build)Console, App config: paywall: fill the four product id fields. They reach phones within about five minutes. Needs the server.
In the app codeapp/lib/brand.dart: set lifetimeIos, lifetimeAndroid, yearlyIos, yearlyAndroid. Used when no server config is reachable.

Leave a product's id empty to not sell it on that platform; the paywall hides it. Store purchases were not exercised by the author because no product ids exist in the source: purchases are untested. Test them yourself before release.

05Changing or removing a plan

What the app does, read from app/lib/src/services/purchases.dart. Check it against your own wording before you change a live plan.

You do thisWhat happens on the phone
Nothing (normal use)After a verified purchase the app saves the kind (lifetime or yearly) and the time the store last confirmed it. Lifetime never expires on the device. A yearly plan is trusted for 35 days after the last confirmation, and the app asks the store again when the last confirmation is older than 7 days.
A yearly subscriber cancels, or the subscription ends or is refunded in the storeThe store stops confirming it. Pro locks when the last confirmation is older than 35 days. The app does not know about the cancellation sooner.
You change a product idOnly purchases for ids in the current list unlock Pro. A restore of a purchase made under the old id is ignored. Plans already saved on a device stay as described above. Keep the old id working, or tell those buyers.
You empty an id or remove a planThat plan disappears from the paywall. People who already bought keep what is saved on their device.
You switch the paywall offEvery installed copy that loads the new setting treats everyone as Pro. Switching it on again limits the people who never bought.
You want to give one person ProThe app has no per-person unlock. Use the store's own tools (promo or offer codes, refunds) or switch the paywall off for everyone.

Store billing and in-app access are separate: the store charges and refunds, the app only reads what the store confirms. With server verification on (Purchase verification) a purchase the server rejects does not unlock Pro.