HistoryResponse
A response that contains the customer’s transaction history for an app.
Declaration
object HistoryResponseProperties
| Name | Type | Description |
|---|---|---|
appAppleId | appAppleId | The app’s identifier in the App Store. |
bundleId | bundleId | The bundle identifier of the app. |
environment | environment | The server environment in which you’re making the request, whether sandbox or production. |
hasMore | hasMore | A Boolean value that indicates whether the App Store has more transactions than it returns in this response. If the value is |
revision | revision | A token you use in a query to request the next set of transactions from the endpoint. |
signedTransactions | [JWSTransaction] | An array of in-app purchase transactions for the customer, signed by Apple, in JSON Web Signature (JWS) format. |
Discussion
The Get Transaction History endpoint returns the HistoryResponse. This response contains results for all in-app purchase product types: auto-renewable subscriptions, non-renewing subscriptions, non-consumables, and consumables. The result includes transactions in any state, including transactions that are refunded or revoked, and transactions that the app has or hasn’t marked as finished.
The history response returns a maximum of 20 transactions per response. If your customer has more than 20 in-app transactions, the hasMore value is true. Each response includes a revision value. Call Get Transaction History again with the revision token in the query to receive the next set of transactions; use the same query parameters for each subsequent call that includes revision. When the App Store has no more transactions to send, the hasMore value is false.
If a customer upgrades a subscription or the App Store revokes an in-app purchase while you’re receiving transaction history, the App Store updates the relevant transaction. If the response is sorted in ASCENDING order, you receive the transaction again, with updated data.