Apple App Store Product

Apple App Store Connect is the platform for managing your iOS and macOS applications, including in-app purchases and subscriptions. In Crosspay, you can create products that correspond to the in-app purchases or subscriptions you have set up in Apple App Store Connect, and link them to entitlements to manage access to features or content in your apps.

There are 3 types of products you can create for the Apple App Store in Crosspay:

1. Consumable - A product that can be purchased multiple times, such as in-game currency or one-time use items.
2. Non-Consumable - A product that can only be purchased once, such as a premium feature or a one-time upgrade.
3. Subscription - A product that grants access to features or content for a specific period of time, and can be set to renew automatically until the user cancels.

Creating Subscriptions

Subscriptions in the Apple App Store are created as auto-renewable subscriptions. To create a subscription product in Crosspay, you need to first set up the subscription in Apple App Store Connect, and then link it to an entitlement in Crosspay.

To create a subscription product in Crosspay, follow these steps:

1. Go to AppStoreConnect > Select your app, on the sidebar go to App Store > Monetization > Subscriptions.
2. Now we need to create a subscription group (if doesn’t exists already). Use the + button next to the title, and give it a good reference name like base subscriptions.
3. Go to that newly created or existing subscription group
4. Create a new subscription by clicking the + button next to the title.
   1. For Reference Name, use a good reference name e.g. Premium Monthly
   2. For Product ID, use a unique identifier that you will use to link this subscription to an entitlement in Crosspay, e.g. com.example.example.premium.monthly.
   3. For Subscription Duration, select the appropriate duration for your subscription (e.g. 1 month).
5. Now we have our subscription in a DRAFT state
6. Setup Availability, set the countries your subscription will be available in.
7. For setting the price,
   1. click on the Add Subscription Price button
   2. Select the appropriate price for your subscription in the Price field and the base currency through the Country or Region field.
   3. On the next page, you configure the price for each region/country if needed.
   4. Finally Confirm the price and you should see the price you set in the subscription details page.
8. Add Localization for the subscription by clicking on the Add Localization button, and filling in the required fields.

You can also setup Introductory Offers, Promotional Offers, and Subscription Offers for your subscription if needed.

Read the official Apple documentation for more details on how to set up subscriptions in Apple App Store Connect: Auto-Renewable Subscriptions.

Tip

All subscriptions in a single subscription group are mutually exclusive, meaning a user can only be subscribed to one subscription in the same group at a time. If you want to have multiple subscription options that users can subscribe to simultaneously, you need to create separate subscription groups for each of those options.

Ideally, for a tier based subscription model, you should have a single subscription group with multiple subscriptions representing each tier. For example, you can have a base subscriptions group with Basic Monthly, Standard Monthly, Premium Monthly etc subscriptions. It is required to support upgrades to a higher tier. Make sure to use Edit Level button in the subscription details page to set the correct level for each subscription in a descending order (e.g. Premium Monthly should have a higher level than Standard Monthly).

Note

All subscriptions in Apple AppStore needs to reviewed and approved by Apple. Otherwise, they will remain in DRAFT state and won’t be purchasable by users. You can submit your subscription for review by clicking on the Submit for Review button in the subscription details page. Learn more about the review process in the official Apple documentation: Submitting Your Subscription for Review.

Creating Consumables and Non-Consumables

Consumable products are created as in-app purchases in Apple App Store Connect. To create a consumable product in Crosspay, you need to first set up the in-app purchase in Apple App Store Connect, and then link it to an entitlement in Crosspay.

To create a consumable product in Crosspay, follow these steps:

1. Go to AppStoreConnect > Select your app, on the sidebar go to App Store > Monetization > In-App Purchases.
2. Click on the + button next to the title. The form to create a new in-app purchase will open.
   1. Type: Select Consumable or Non-Consumable depending on the type of product you want to create.
   2. Reference Name: a good reference name for your in-app purchase, e.g. 100 Coins or Lifetime Access.
   3. Product ID: a unique identifier that you will use to link this in-app purchase to an entitlement in Crosspay, e.g. com.example.example.100_coins or com.example.example.lifetime_access.
   4. Click Create to create the in-app purchase.
3. Now we have our in-app purchase in a DRAFT state.
4. Setup Availability, set the countries your in-app purchase will be available in.
5. For setting the price,
   1. click on the Add Pricing button in Price Schedule section.
   2. Select the appropriate price for your in-app purchase in the Price field and the base currency through the Country or Region field.
   3. On the next page, you configure the price for each region/country if needed.
   4. Finally Confirm the price and you should see the price you set in the in-app purchase details page.
6. Add Localization for the in-app purchase by clicking on the Add Localization button, and filling in the required fields.

You can also setup Promotional Offers for your in-app purchase if needed.

Read the official Apple documentation for more details on how to set up in-app purchases in Apple App Store Connect: In-App Purchases.

Note

Just like subscriptions, all in-app purchases in Apple AppStore needs to reviewed and approved by Apple. Otherwise, they will remain in DRAFT state and won’t be purchasable by users. You can submit your in-app purchase for review by clicking on the Submit for Review button in the in-app purchase details page. Learn more about the review process in the official Apple documentation: Submitting Your In-App Purchase for Review.

Linking to Entitlements

After your subscriptions & in-app purchases are created in Apple App Store Connect, these are ready to be linked with Crosspay, yay!

• If you go the Crosspay Products Page you’ll find the Apple App Store section with a button to create a new product.
• You will see the newly created subscription/in-app purchase is listed there, click it, and save it!

Now your subscription/in-app purchase is linked with Crosspay!!