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`	Timestamp¹	Timestamp when the subscription first started / was originally purchased.
`current_period_start_at`	Timestamp¹	The date and time when the current subscription period started (Only available on subscription purchases)
`current_period_end_at`	Timestamp¹	The date and time when the current subscription period will/has ended. (Only available on subscription purchases)
`canceled_at`	Timestamp¹	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`	Timestamp¹	The date and time when the record was created.
`updated_at`	Timestamp¹	The date and time when the record was most recently updated.
`last_synced_at`	Timestamp¹	The date and time when the record was last synced with the marketplace API

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
}
```
↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶ ↩⁷