A client for the App Store Server API
npm install app-store-server-apibash
npm install app-store-server-api
`Usage
$3
To get started, you must obtain the following:
- An API key
- The ID of the key
- Your issuer IDA note on the issuer ID:
Apple's documentation currently has incorrect instructions on how to obtain this.
To get your issuer ID, you must create an API key for App Store Connect (not the App Store Server API). Only after creating your first API key will the issuer ID appear.
$3
`javascript
const { AppStoreServerAPI, Environment, decodeRenewalInfo, decodeTransaction, decodeTransactions } = require("app-store-server-api")
// or
import { AppStoreServerAPI, Environment, decodeRenewalInfo, decodeTransaction, decodeTransactions } from "app-store-server-api"const KEY =
-----BEGIN PRIVATE KEY-----const KEY_ID = "ABCD123456"
const ISSUER_ID = "91fa5999-7b54-4363-a2a8-265363fa6cbe"
const APP_BUNDLE_ID = "com.yourcompany.app"
const api = new AppStoreServerAPI(
KEY, KEY_ID, ISSUER_ID, APP_BUNDLE_ID, Environment.Production
)
`$3
`javascript
const response = await api.getTransactionHistory(originalTransactionId)// Decoding not only reveals the contents of the transactions but also verifies that they were signed by Apple.
const transactions = await decodeTransactions(response.signedTransactions)
for (let transaction of transactions) {
// Do something with your transactions...
}
// The response contains at most 20 entries. You can check to see if there are more.
if (response.hasMore) {
const nextResponse = await api.getTransactionHistory(originalTransactionId, { revision: response.revision })
// ...
}
`The library supports the filter and sort options introduced at WWDC 2022.
See Get Transaction History for a list of available options.
`javascript
// Import parameter types
import { ProductTypeParameter, SortParameter } from "app-store-server-api"const response = await api.getTransactionHistory(originalTransactionId, {
productType: ProductTypeParameter.AutoRenewable,
sort: SortParameter.Descending,
})
`
$3
`javascript
const response = await api.getSubscriptionStatuses(originalTransactionId)// Find the transaction you're looking for
const item = response.data[0].lastTransactions.find(item => item.originalTransactionId === originalTransactionId)
const transactionInfo = await decodeTransaction(item.signedTransactionInfo)
const renewalInfo = await decodeRenewalInfo(item.signedRenewalInfo)
`$3
`javascript
// Import the status type
import { OrderLookupStatus } from "app-store-server-api"const response = await api.lookupOrder(orderId)
if (response.status === OrderLookupStatus.Valid) {
const transactions = await decodeTransactions(response.signedTransactions)
/// ...
}
`$3
`javascript
const response = await api.requestTestNotification()
// response.testNotificationToken identifies the notification that will be sent.
`$3
`javascript
const response = await api.getTestNotificationStatus("ae0e2185-a3c6-47e4-b41a-6ef4bc86314e_1656062546521")
`$3
`javascript
// Start and end date are required.
// The earliest supported start date is June 6th (the start of WWDC 2022).
const response = await api.getNotificationHistory({
startDate: 1654466400000, // June 6th 2022
endDate: new Date().getTime()
})// Check if there are more items.
if (response.hasMore) {
// Use history.paginationToken to fetch additional items.
}
`$3
The App Store Server API and App Store Server Notifications (version 2) are closely related and use some of the same types and encoding formats. This library includes a function to help you decode notifications (which will also verify their signature).`javascript
import { decodeNotificationPayload, isDecodedNotificationDataPayload, isDecodedNotificationSummaryPayload } from "app-store-server-api"// signedPayload is the body sent by Apple
const payload = await decodeNotificationPayload(signedPayload)
// You might want to check that the bundle ID matches that of your app
if (payload.data.bundleId === APP_BUNDLE_ID) {
// Handle the notification...
}
// Notifications can contain either a data field or a summary field but never both.
// Use the provided type guards to determine which is present.
if (isDecodedNotificationDataPayload(payload)) {
// payload is of type DecodedNotificationDataPayload
}
if (isDecodedNotificationSummaryPayload(payload)) {
// payload is of type DecodedNotificationSummaryPayload
}
`$3
When using StoreKit testing in Xcode, transactions will be signed by a local certificate authority (CA) instead of Apple's.
To verify these you must export the root certificate generated by Xcode and obtain its SHA256 fingerprint.
This can be passed in to the various decoding functions:
`javascript
import { decodeTransactions, APPLE_ROOT_CA_G3_FINGERPRINT } from "app-store-server-api"const LOCAL_ROOT_FINGERPRINT = "AA:BB:CC:DD:..."
const fingerprint = (process.env.NODE_ENV === "production") ? APPLE_ROOT_CA_G3_FINGERPRINT : LOCAL_ROOT_FINGERPRINT
const transactions = await decodeTransactions(response.signedTransactions, fingerprint)
``WWDC videos:
- Manage in-app purchases on your server
- Meet StoreKit 2
- Support customers and handle refunds
- What's new with in-app purchase
- What's new in App Store server APIs