Develop
Develop
Select your platform

Choose a monetization SDK

Updated: Apr 2, 2026

Overview

Meta provides two libraries for monetizing Android apps on Horizon OS: the Platform SDK and the Horizon Billing Compatibility SDK. Both support consumable, durable, and subscription in-app purchases, but they differ in API design, migration effort, and breadth of features.
Use this guide to understand the tradeoffs and choose the right library for your app.

At a glance

 Platform SDKHorizon Billing Compatibility SDK
Best for
New Horizon OS apps and apps that need platform features beyond billing
Existing Android apps already using Google Play Billing
API style
Native Meta Kotlin APIs with coroutines
Google Play Billing Library v7.0-compatible API
IAP types
Consumable, durable, subscription, DLC/asset files
Consumable, durable, subscription
Migration effort from Google Play Billing
Requires rewriting billing code to Meta APIs
Minimal — swap import prefixes
Additional platform features
Achievements, leaderboards, group presence, users, notifications, and more
Billing only (with user age category support)
Dependency
Standalone foundation SDK
Built on top of the Platform SDK

Platform SDK

The Platform SDK is Meta’s comprehensive SDK for building apps on Horizon OS. Its IAP module provides native APIs for monetization, and the broader SDK gives access to social, engagement, and platform features.

Benefits

  • Full platform access — A single SDK gives you IAP along with achievements, leaderboards, group presence, user profiles, notifications, DLC/asset file downloads, and more.
  • Native Kotlin API — Built with Kotlin coroutines and idiomatic patterns, providing a modern async development experience.
  • DLC and asset file support — Download and manage large content files directly through the SDK, which the Billing Compatibility SDK does not support.
  • Server-to-server APIs — Dedicated S2S APIs for server-side purchase verification and subscription management.
  • No compatibility layer — Direct access to the platform without a translation layer, reducing potential surface area for bugs.

Tradeoffs

  • Higher migration effort — If you have an existing Google Play Billing integration, you will need to rewrite your billing code to use Meta’s API surface.
  • Meta-specific API — Code written against the Platform SDK is specific to Horizon OS. You will need to maintain separate billing integrations for Google Play and the Meta Horizon Store.

When to use the Platform SDK

  • You are building a new app for Horizon OS, or your app does not have an existing Google Play Billing integration.
  • You need platform features beyond billing, such as achievements, leaderboards, group presence, or DLC downloads.
  • You want a single SDK for all platform interactions.
  • You prefer native Kotlin APIs with coroutine support.

Horizon Billing Compatibility SDK

The Horizon Billing Compatibility SDK provides a Google Play Billing Library-compatible API surface. It is designed to let you port existing billing code to the Meta Horizon Store with minimal changes.

Benefits

  • Minimal migration effort — In most cases, you only need to replace com.android.billingclient.api imports with com.meta.horizon.billingclient.api. Your existing billing logic, listeners, and purchase flow code remain largely unchanged.
  • Familiar API — If your team already knows the Google Play Billing Library, there is no new API to learn.
  • Shared billing code — You can maintain a single billing codebase with a build flavor or import swap to target both the Google Play Store and the Meta Horizon Store.

Tradeoffs

  • Billing only — This SDK only handles in-app purchases. If you need achievements, leaderboards, group presence, or other platform features, you must also integrate the Platform SDK separately.
  • No DLC/asset file support — Downloadable content management is not available through this SDK.
  • Known limitations — Some Google Play Billing features are stubs or not fully supported, including alternative billing, external offers, in-app messaging, and billing configuration. Only single-item checkout flows are supported. See Known Limitations for the full list.
  • Compatibility layer overhead — The SDK wraps the Platform SDK internally, which adds an additional dependency and abstraction layer.

When to use the Horizon Billing Compatibility SDK

  • You have an existing Android app with a working Google Play Billing integration and want to port it to the Meta Horizon Store quickly.
  • You want to minimize code changes and reuse your existing billing logic.
  • Billing is your only platform need — you do not require achievements, leaderboards, group presence, or other platform services.
  • You want to maintain a shared billing codebase across Google Play and the Meta Horizon Store.

Recommendation

For most developers, the decision comes down to one question: Do you already have a Google Play Billing integration?
  • Yes — Start with the Horizon Billing Compatibility SDK to get your app on the Meta Horizon Store quickly. If you later need platform features like achievements or leaderboards, you can integrate the Platform SDK alongside it.
  • No — Use the Platform SDK directly. It gives you native APIs, full platform access, and avoids the limitations of the compatibility layer.
If you are building a new cross-platform app that will ship on both Google Play and the Meta Horizon Store, consider using the Horizon Billing Compatibility SDK for billing to share code between platforms, and add the Platform SDK for any Horizon OS-specific features you need.