This resource unifies representation of the subscription data across multiple sources , such as the Apple App Store and Google Play Store. It provides one-to-one mapping of underlying data into Chargebee's omnichannel format. Acting as a middleware , the solution delivers data in a unified format as it is presented.
Note: This resource represents in-app subscriptions made on Apple App Store and Google Play Store.
{
"id": "__test__os_AHsdfs123ld1",
"app_id": "__test__gps_sdfwerzx5134",
"customer_id": "__test__XpbTXGTSRp3gEsD8",
"id_at_source": "20000006743",
"source": "google_play_store",
"created_at": 1517487053,
"object": "omnichannel_subscription",
"omnichannel_subscription_items": [
{
"id": "__test__osi_BXswds133lf1",
"id_at_source": "com.example.landmarks.premium",
"status": "active",
"current_term_start": 1728988425,
"current_term_end": 1731666825,
"omnichannel_subscription_item_offers": [
{
"id": "__test__off__AHsdfs123LD1",
"offer_id_at_source": "intro_offer_google_monthly",
"category": "introductory",
"category_at_source": "INTRODUCTORY",
"type": "free_trial",
"type_at_source": "FREE_TRIAL",
"discount_type": "percentage",
"duration": "P1M",
"percentage": 50,
"price_currency": "USD",
"price_units": 2,
"price_nanos": 90000000,
"offer_term_start": 1752676649,
"offer_term_end": 1755268649
}
]
}
]
}The identifier of the subscription in the source.
For Apple App Store, it is the Transaction ID
of the initial_purchase_transaction
.
App Identifier in Chargebee. This is the handle created by Chargebee for your app. To get the app_id:
The id
of the customer
object that is associated with this purchase.
Indicates timestamp when the omnichannel_subscription
created in Chargebee.
Version number of this resource. The resource_version
is updated with a new timestamp in milliseconds for every change made to the resource.
Items associated with the omnichannel_subscription.
Refers to the record created when a customer makes their first purchase.
Indicates timestamp when the grace period of subscription associated with the omnichannel_subscription_item
expires in the source
Indicates timestamp when the subscription associated with the omnichannel_subscription_item
was cancelled
in the source
Indicates timestamp when the subscription associated with the omnichannel_subscription_item
was expired
in the source
End of the current billing period of the subscription item. It is applicable only if the status
is active.
Note: This timestamp can be considered closest to the next_billing_at timestamp as Apple does not provide information on the next renewal. Apple can renew the subscription 24 hours before it expires, and after entering the billing retry state, it can attempt to renew the subscription for up to 60 days. Learn more .
Start of the current billing period of the subscription item. It is applicable only if the status
is active
.
Status of the omnichannel_subscription_item.
Learn more
about status and their mapping with the store's status.
Represents the omnichannel_subscription_item_offers
associated with the omnichannel_subscription_item
.
This field contains information about the upcoming renewal. It is present only if the source
provides renewal information (currently available only for Google Play Store purchases) and the omnichannel_subscription_item
's auto_renew_status
is set to on
to renew for the next term. Otherwise, this field is absent.
Represents an active product catalog mapping between an omnichannel_subscription_item
and a Chargebee item.
Use this attribute to retrieve entitlements for the omnichannel_subscription_item
that are associated with the linked Chargebee item
.
Timestamp denoting the time when the transaction occurred in source
The fractional price amount, in nanos (billionths of the currency unit), for the next renewal.
The value must be between 0 and +999,999,999 inclusive.
For example:
If currencyCode is USD (i.e. two decimal currency), then nanos value for USD 1.23 will be 230,000,000
If currencyCode is JPY (i.e. zero decimal currency), then nanos value for JPY 123 will be 0
If currencyCode is BHD (i.e. three decimal currency), then nanos value for BHD 1.234 will be 234,000,000
The whole units of the amount.
For example:
if currencyCode is USD (i.e. two decimal currency), then the unit value for USD 1.23 will be 1
if currencyCode is JPY (i.e. zero decimal currency), then the unit value for JPY 123 will be 123
if currencyCode is BHD (i.e. three decimal currency), then the unit value for BHD 1.234 will be 1
App Identifier in Chargebee. This is the handle created by Chargebee for your app. To get the app_id:
The identifier of the subscription in the source.
For Apple App Store, it is the Transaction ID
of the initial_purchase_transaction.
For Google Play Store, it is the Order ID
of the initial_purchase_transaction
.
A list of omnichannel_subscription
objects linked to this transaction. Each entry represents a subscription associated with the initial purchase transaction.
A list of omnichannel_one_time_order
objects linked to this transaction. Each entry represents a one-time order associated with the initial purchase transaction.
Retrieves an omnichannel_subscription object using an omnichannel_subscription_id. You can get the omnichannel_subscription_id for any successfully recorded purchase in Chargebee using List Omnichannel subscriptions API.
Returns a list of omnichannel_subscription
.
Returns a list of omnichannel_transaction
associated with the specified omnichannel_subscription
.
Moves an omnichannel_subscription
to another customer. Updates the Omnichannel subscription's customer ID and related records, then triggers the OMNICHANNEL_SUBSCRIPTION_MOVED_IN
webhook with the new customer details.