Getting started with appstore connector setup

1. Account Creation

Set up the user account in the system, which will serve as the foundation for creating and managing subscriptions.

Steps:

1. Verify that the user’s basic profile information (e.g., email, name, payment details) is available for account creation.
2. Use the system's account creation API or user interface to establish the account in the relevant environment (e.g., staging, production).
3. Confirm account creation success by retrieving and verifying the user’s unique account ID.

2. OmniChannel Subscription Creation

Enable the OmniChannel Subscription, which allows the account to manage and synchronize subscriptions across multiple platforms, including Apple.

Steps:

1. Initialize an OmniChannel Subscription request in the system.
2. Specify the account ID created in the previous step.
3. Define the subscription type, billing cycle, and additional parameters based on the subscription level and Apple’s requirements.
4. Execute the request and retrieve the OmniChannel Subscription ID for confirmation.

Required Fields: Account ID

3. ExternalSubscriptionId Field Mapping to Apple’s OriginalTransactionId

Map the ExternalSubscriptionId field in the system to Apple's OriginalTransactionId to synchronize Apple subscription transactions with system records.

Steps:

1. Retrieve Apple’s OriginalTransactionId for the user’s subscription from Apple’s subscription API.
2. Map this OriginalTransactionId to the system’s ExternalSubscriptionId field, ensuring accurate linkage between the platforms.
3. Verify the mapping by confirming the external subscription data is accessible and aligned with Apple’s records.

Required Field Mappings:

• ExternalSubscriptionId ➔ Apple’s OriginalTransactionId

1. Create Apple Products in the Zuora Product Catalog (Optional)

Align Zuora product listings with Apple products available on app stores for improved management and reporting. This step is optional, as it is only necessary if you want to ensure that Zuora product listings are directly synchronized with the Apple products in the app stores, enhancing visibility and reporting accuracy.

Steps:

1. Navigate to the Zuora Dashboard.
2. Go to Product Catalog and select Add Product.
3. Enter the necessary details for Apple products, including names, descriptions, and pricing information.
4. Save the new products to the catalog.

2. Product Mapping

Ensure that subscription changes and purchases from the app store are accurately reflected in Zuora by mapping Apple product identifiers to Zuora product rate plans.

Steps:

1. Go to the Product Catalog in Zuora.
2. Select Rate Plans and choose the rate plans to map.
3. Enter the Apple product identifier (e.g., Apple SKU or Product ID) in the corresponding fields, and add it to the ExternallyManagedPlanID field as needed.
4. Save the mappings to link Apple products with Zuora rate plans.

3. Subscription Management

Follow guidelines to effectively manage subscriptions and billing, ensuring proper handling of subscriber accounts and payment processes.

Steps:

1. Refer to the Omnichannel User Guide for detailed instructions related to subscription management.
2. Follow the guide to set up and manage subscriptions, configure billing settings, and handle subscription lifecycle events.

1. Create Google Products in the Zuora Product Catalog (Optional)

Align Zuora product listings with Google Play products to improve management and reporting. This step is optional but helpful for maintaining synchronized and accurate records.

Steps:

1. Navigate to the Zuora Dashboard.
2. Go to the Product Catalog and select Add Product.
3. Enter details for Google Play products, including names, descriptions, and pricing.
4. Save the new products to the catalog.

2. Product Mapping

Ensure that subscription changes and purchases from the Google Play Store are accurately reflected in Zuora by mapping Google product identifiers to Zuora product rate plans.

Steps:

1. Go to the Product Catalog in Zuora.
2. Select Rate Plans and choose the rate plans to map.
3. Enter the Google product identifier (e.g., purchaseToken or other relevant Google identifiers) in the corresponding fields and add it to the ExternallyManagedPlanID field as needed.
4. Save the mappings to link Google Play products with Zuora rate plans.

3. Subscription Management

Follow the guidelines to manage subscriptions and billing, ensuring proper handling of subscriber accounts and payment processes.

Steps:

1. Refer to the Omnichannel User Guide for detailed instructions on subscription management.
2. Follow the guide to set up and manage subscriptions, configure billing settings, and handle lifecycle events like renewals, cancellations, or upgrades.

1. Credential Setup

Authenticate and connect to Roku Pay by providing necessary credentials in Zuora.

Steps:

1. Obtain your Roku channel_id (the unique identifier for your Roku channel).
2. Obtain your Roku api_key (the API key for accessing Roku Pay services).
3. Add the channel_id and api_key to the Zuora configuration in the appropriate settings section.

2. Create Roku Products in the Zuora Product Catalog (Optional)

Maintain synchronization between Roku products and Zuora product listings to enhance visibility and reporting.

Steps:

1. Navigate to the Zuora Dashboard.
2. Go to the Product Catalog and select Add Product.
3. Enter the necessary details for Roku products, including names, descriptions, and pricing.
4. Save the new products to the catalog.

3. Product Mapping (Optional)

Ensure accurate reflection of subscription data from Roku Pay by mapping Roku product identifiers to Zuora product rate plans.

Steps:

1. Go to the Product Catalog in Zuora.
2. Select Rate Plans and choose the rate plans to map.
3. Enter the Roku product identifier (e.g., channel_id) in the corresponding fields and add it to the ExternallyManagedPlanID field as needed.
4. Save the mappings to link Roku products with Zuora rate plans.

4. Subscription Management

 Effectively manage Roku subscriptions and billing to ensure proper handling of subscriber accounts and renewals.

Steps:

1. Refer to the Omnichannel User Guide for detailed instructions on subscription management.
2. Follow the guide to configure billing settings, manage renewals, and handle lifecycle events like cancellations or upgrades.