Glossary - In-App Purchase Resource

Our Data Refinery assembles in-app purchase data from app-initiated RPC requests, receipt validation API’s, real-time subscription status updates, financial and analytical reports (coming soon) and various other sources to produce a definitive and complete portrait of your in-app purchase data.

Disparate and ambiguous data is refined within a common context, providing a rich, uniformed and integrated in-app purchase data resource regardless of marketplace.

The table below describes the In-App Purchase Resource’s properties.

Name Type Description
id UUID Mbaasy database ID for the In App Purchase.
app_family_id UUID Mbaasy database ID for the App Family.
fact_id UUID Mbaasy database ID for the In App Purchase Fact.
version Integer The number of versions (changes) that are recorded for this purchase.
marketplace String The marketplace the purchase was made.
app_identifier String Unique identifier for the app.
product_id String Marketplace Product ID / SKU for the purchase.
quantity Integer Number of items purchased.
type String Type of purchase.
environment String Environment of the purchase.
country_code String ISO 3166-1 alpha-2 country code / region code of the app store user.
currency_code String ISO 4217 currency code associated to the country_code.
user_identifier String The user_identifier received via an uploaded receipt / purchase order.
is_auto_renewing Boolean Indicates the auto-renewing status of the subscription.
in_trial_period Boolean Indicates if the subscription is in the trial period.
in_grace_period Boolean Indicates if the marketplace is still trying to renew the subscription.
metadata Object The metadata received via an uploaded receipt / purchase order.
entitlements Array[String] Lists the matched entitlement/offering combinations.
purchased_at Timestamp1 Timestamp when the subscription first started / was originally purchased.
current_period_start_at Timestamp1 The date and time when the current subscription period started (Only available on subscription purchases)
current_period_end_at Timestamp1 The date and time when the current subscription period will/has ended. (Only available on subscription purchases)
canceled_at Timestamp1 The date the purchase was canceled or auto renewing was disabled
canceled_by String By whom the purchase was canceled by. Possible values are: user, publisher, marketplace or unknown.
created_at Timestamp1 The date and time when the record was created.
updated_at Timestamp1 The date and time when the record was most recently updated.
last_synced_at Timestamp1 The date and time when the record was last synced with the marketplace API
  1. Timestamps are objects that contain an ms (Unix Timestamp in milliseconds) and utc property. e.g.

    {
      "utc": "2018-02-26 10:35:47 UTC",
      "ms": 1519641347834
    }
    

     2 3 4 5 6 7