ChargebeeAPI

Omnichannel transactions

A unified representation of Transaction across multiple source.

Apple App Store

The price value reflects the price you configured in App Store Connect, which the system records at the time of transaction (transacted_at) after the discount if any offers are applied.

Important For financial and accounting purposes, use the App Store Connect reporting tools. For more information, see Download financial reports and Overview of reporting tools. Learn more about price in Apple App Store.

Google Play Store

The Google Play Store does not provide the transaction amount or the purchase time. As a result, the system does not record the price value or time of the transaction(transacted_at).

Sample Omnichannel transactionJSON

Omnichannel transactions attributes

id
required, string, max chars=40

The ID generated by Chargebee for the recorded purchase.

id_at_source
required, string, max chars=100

The id of the transaction in the 'source'. For Apple App Store, it is the 'Transaction ID' of the initial subscription purchase transaction

app_id
required, string, max chars=100

App Identifier in Chargebee. This is the handle created by Chargebee for your app. To get the app_id:

price_currency
optional, string, max chars=3

The three-letter ISO 4217 currency code associated with the transaction

price_units
optional, long

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

price_nanos
optional, long

The fraction part of the amount. 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

type
required, enumerated string

Omni-subscription transaction type that describes the transaction

Possible Enum Values
purchase

Indicates that the transaction occurred for a purchase.

renewal

Indicates that the transaction was initiated as part of a renewal for a previously completed purchase.

transacted_at
optional, timestamp(UTC) in seconds

Timestamp denoting the time when the transaction occurred in Source

created_at
required, timestamp(UTC) in seconds

Omnichannel Transaction created time

resource_version
optional, long

Version number of this resource. The resource_version is updated with a new timestamp in milliseconds for every change made to the resource.

linked_omnichannel_subscriptions
optional, list of linked_omnichannel_subscription
linked_omnichannel_one_time_orders
optional, list of linked_omnichannel_one_time_order