capabilities.work

Launch a Subscription Product with an Introductory Offer

A 4-step recipe with Android. We can help you get access.

Recipe · 4 steps

Launch a Subscription Product with an Introductory Offer

with Android · Plan & Entitlement Design

Create a subscription, confirm its base plan, attach an introductory offer, and list the offers back.

  1. Create the subscription product with its base plans and localized listings. The product id travels as a query parameter, not in the body.
  2. Read the subscription back to confirm the base plan the offer will attach to actually exists before attempting to create the offer.
  3. Create the introductory offer — a free trial or discounted price — against the confirmed base plan. The offer id travels as a query parameter.
  4. List the base plan's offers to verify the new introductory offer is present and to capture its state before it is rolled out to subscribers.
What you'll need to have ready
  • packageName: The package name of the application (e.g. com.example.myapp).
  • productId: The id to use for the new subscription. Must be unique within the app (e.g. premium_monthly).
  • basePlanId: The id of the base plan defined in basePlans that the offer attaches to (e.g. monthly-autorenewing).
  • offerId: The id to use for the new offer. Must be unique within the base plan (e.g. freetrial7d).
  • basePlans: The base plans to create on the subscription, each with its basePlanId, state, regionalConfigs, and renewal type.
  • listings: The localized store listings for the subscription, each with a languageCode, title, benefits, and description.
  • offerPhases: The pricing phases for the introductory offer, each with a duration, recurrenceCount, and regionalConfigs.
  • offerRegionalConfigs: Per-region availability configuration for the offer, each with a regionCode and newSubscriberAvailability.
  • offerTags: Offer tags exposed to the app at purchase time.
  • taxAndComplianceSettings: Tax and legal compliance settings for the subscription, including EEA withdrawal right type and per-region tax rate info.
  • regionsVersion: The version of the available regions being used for pricing.
For your developer

Arazzo workflow android:launch-subscription-product, 4 operations: createSubscription → getSubscription → createSubscriptionOffer → listSubscriptionOffers. Specs on APIs.io.

More recipes with Android

Audit and Update a Subscription ProductCancel a Subscription PurchaseDefer a Subscription RenewalGrant and Consume a Consumable PurchaseReconcile Voided PurchasesRefund a Play OrderRetire an Unpublished Subscription ProductTriage and Reply to App ReviewsRevoke and Refund a Subscription PurchaseVerify and Acknowledge an In-App Product Purchase