## Zoho Billing - Product, solutions, integrations, support, and resources Index Access the complete documentation index at: https://www.zoho.com/es-mx/billing/llms.txt Use this file to discover all available documentation pages before proceeding. # Omnichannel Subscriptions - Overview **Note:** This feature is currently in early access. Reach out to our support team at [](mailto:support@zohobilling.com)[support@zohobilling.com](mailto:support@zohobilling.com) to enable it for your organization. **Omnichannel Subscriptions** lets you consolidate subscriptions purchased by your customers through mobile apps, such as the Google Play Store and Apple App Store, into a single billing system. Instead of managing subscriptions separately on each platform, you can centralize subscription data in Zoho Billing while continuing to let customers subscribe through their preferred channel. With Omnichannel Subscriptions, subscriptions purchased through your mobile apps, hosted payment pages, and offline channels are unified under each customer in Zoho Billing. You can track all lifecycle events from your Zoho Billing organisation. **Scenario:** Patricia Boyle, a customer at Zylker, subscribes to a monthly premium plan through the Google Play Store. Without a unified system, Zylker’s team would need to check the Play Console separately to track and update her subscription manually. With Omnichannel Subscriptions, Zoho Billing syncs Patricia’s subscription automatically. Her renewals, upgrades, cancellations, and payment status are updated in the same customer record, eliminating the need to switch between systems to manage her subscription. * * * ## Understanding Omnichannel Subscriptions Omnichannel Subscriptions gives you a single view of subscriptions created from: * Mobile marketplaces (Apple App Store and Google Play Store) * Hosted payment pages * Offline subscriptions recorded in Zoho Billing. When a customer purchases through an app store, Zoho Billing validates the purchase, maps it to the corresponding plan, and syncs the subscription and payment details. From then on, every lifecycle event updates the same subscription record. This includes: * Purchases * Renewals * Upgrades and downgrades * Subscription pauses and resumes * Cancellations * Expirations * * * ## Terms to Remember This overview includes the core terms you will use during setup and validation. Term Definition **Entitlement** Access rights a user gets based on an active subscription. **Provisioning** Granting access to paid features after a purchase or restore is validated. **Channel Notification URL** Zoho Billing webhook endpoint that receives real-time store lifecycle events. **In-App Purchase Kit** Zoho Billing SDK for iOS and Android that connects store purchases to Zoho Billing. **Introductory Offer** First-time subscriber promotion configured in the store, such as a trial or reduced price. **Promotional Offer** iOS discount offer for existing or lapsed subscribers, applied using a backend-generated signature. **Subscription Group** App Store grouping of related plans that controls offer eligibility and switching behavior. **Sandbox Purchase** Test purchase in the app store sandbox used to verify end-to-end subscription sync. * * * ## How Omnichannel Subscriptions Works Omnichannel Subscriptions uses the Zoho Billing _In-App Purchase SDK_ to connect your mobile application with Zoho Billing and the respective app stores. When a customer purchases, renews, upgrades, downgrades, or cancels a subscription through Apple App Store or Google Play Store, the SDK validates the purchase and synchronizes the subscription details with Zoho Billing. This creates a single source of truth for the customer’s subscription state across the store and Zoho Billing. ### Setting Up Omnichannel Subscriptions Use the checklist below to set up Omnichannel Subscriptions for your app. Each step prepares the app store, your organisation, and the SDK so purchases, renewals, and entitlements are synced correctly. #### Prerequisites * Review the [SDK implementation guide](/es-mx/billing/help/omnichannel-subscription/sdk-configuration.html). This covers how to link purchases to the right customer, currency configuration, product mapping, and data centre selection. * Confirm your app can process in-app purchases in the Apple App Store or Google Play Store sandbox environment before launch. Initial versions can be tested with in-app purchase flows even before the app is published. * Ensure your Zoho Billing role has access to the Settings module. * Verify that your app store plans and Zoho Billing plans will use the same product IDs or plan codes. #### iOS Setup * **[App Store Integration](/es-mx/billing/help/omnichannel-subscription/ios/app-store-integration.html)** - Connect App Store with Zoho Billing and generate your Developer ID, Shared Secret, Issuer ID, and API keys. This enables Zoho Billing to validate App Store purchases for your organisation. * **[Configure Channel Notification URL](/es-mx/billing/help/omnichannel-subscription/ios/configure-notifications.html)** - Set up App Store Server Notifications so Zoho Billing receives real-time subscription lifecycle events. * **[Set Up Plans](/es-mx/billing/help/omnichannel-subscription/ios/set-up-plans.html)** - Create subscription products in App Store Connect and matching plans in Zoho Billing. Ensure each Plan Code exactly matches the App Store Product ID. * **[Integrate the iOS SDK](/es-mx/billing/help/omnichannel-subscription/ios/ios-sdk-implementation.html)** - Install `ZSInAppPurchaseKit` and initialise it with your API key, Product ID, and data centre. * Implement purchase flow, restore purchase, and error handling in your app so users can complete purchases and recover from failed syncs. #### Android Setup * **[Play Store Integration](/es-mx/billing/help/omnichannel-subscription/android/play-store-integration.html)** - Connect Google Play Store with Zoho Billing and generate the service account and `.p12` key used for secure API access. * **[Configure the Webhook](/es-mx/billing/help/omnichannel-subscription/android/configure-webhook.html)** - Set up Cloud Pub/Sub so Play Store subscription events are delivered to Zoho Billing in real time. * **[Set Up Plans](/es-mx/billing/help/omnichannel-subscription/android/set-up-plans.html)** - Create subscription products in Play Console and matching plans in Zoho Billing. Ensure the plan codes exactly match the Product IDs configured in the store. * **[Integrate the Android SDK](/es-mx/billing/help/omnichannel-subscription/android/android-sdk-implementation.html)** - Install `ZSInAppPurchaseKit` and initialise it with your API key, Product ID, and data centre. * Implement purchase flow, restore purchase, and error handling in your app so active subscriptions can be validated and restored correctly. **Note:** Use the platform-specific getting started guides for [iOS](/es-mx/billing/help/omnichannel-subscription/ios/overview.html) and [Android](/es-mx/billing/help/omnichannel-subscription/android/overview.html) for step-by-step instructions on each checklist item. * * * ## Zoho Billing In-App Purchase SDK Zoho Billing provides an In-App Purchase SDK for [Android](https://zoho.github.io/zsinappkit-docs/android/) and [iOS](https://zoho.github.io/zsinappkit-docs/apple/). The SDK connects your app store purchases with your Zoho Billing organisation so subscription events are synced automatically. Before integrating the SDK into your app, review the [SDK implementation guide](/es-mx/billing/help/omnichannel-subscription/sdk-configuration.html). It covers key guidance such as customer matching, currency configuration, product mapping, and data centre selection that applies to both iOS and Android implementations. * * * ## Things to Know Before You Begin Before you set up Omnichannel Subscriptions, keep the following in mind: * For in-app purchases, invoices and payment receipts are generated by the respective app store, not by Zoho Billing. * Zoho Billing provides subscription-level visibility for in-app subscriptions. Transaction-level invoices generated by the app stores are not synced to Zoho Billing reports. * Offers and discounts are managed in the respective app store. Zoho Billing reflects only the final amount charged to the customer. * For example, if the store price is $100 and a $5 discount is applied, Zoho Billing records the subscription amount as $95. * Plan codes or product IDs must be mapped correctly. If the IDs are mismatched, the app store cannot sync the subscription to the correct Zoho Billing plan. * Store notifications and entitlement checks should be validated in the sandbox environment before production launch. This helps prevent duplicate or incorrect subscription states when users upgrade, retry, or restore purchases. **Pro Tip:** To view transaction-level details for offers and discounts applied to individual purchases, refer to the financial reports in **App Store Connect** (for iOS) or **Google Play Console** (for Android). * * *