Class AppStoreServerAPIClient

Constructors

constructor

new AppStoreServerAPIClient(
    signingKey: string,
    keyId: string,
    issuerId: string,
    bundleId: string,
    environment: Environment,
): AppStoreServerAPIClient
Create an App Store Server API client
Parameters
- signingKey: string
  Your private key downloaded from App Store Connect
- keyId: string
  Your private key ID from App Store Connect
- issuerId: string
  Your issuer ID from the Keys page in App Store Connect
- bundleId: string
  Your app’s bundle ID
- environment: Environment
  The environment to target
Returns AppStoreServerAPIClient
- Defined in index.ts:129

Methods

configureDefaultMessage

configureDefaultMessage(
    productId: string,
    locale: string,
    defaultConfigurationRequest: DefaultConfigurationRequest,
): Promise<void>
Configure a default message for a specific product in a specific locale.
Parameters
- productId: string
  The product identifier for the default configuration.
- locale: string
  The locale for the default configuration.
- defaultConfigurationRequest: DefaultConfigurationRequest
  The request body that includes the message identifier to configure as the default message.
Returns Promise<void>
Throws
APIException If a response was returned indicating the request could not be processed Configure Default Message
- Defined in index.ts:497

deleteDefaultMessage

deleteDefaultMessage(productId: string, locale: string): Promise<void>
Delete a default message for a product in a locale.
Parameters
- productId: string
  The product ID of the default message configuration.
- locale: string
  The locale of the default message configuration.
Returns Promise<void>
Throws
APIException If a response was returned indicating the request could not be processed Delete Default Message
- Defined in index.ts:509

deleteImage

deleteImage(imageIdentifier: string): Promise<void>
Delete a previously uploaded image.
Parameters
- imageIdentifier: string
  The identifier of the image to delete.
Returns Promise<void>
Throws
APIException If a response was returned indicating the request could not be processed Delete Image
- Defined in index.ts:439

deleteMessage

deleteMessage(messageIdentifier: string): Promise<void>
Delete a previously uploaded message.
Parameters
- messageIdentifier: string
  The identifier of the message to delete.
Returns Promise<void>
Throws
APIException If a response was returned indicating the request could not be processed Delete Message
- Defined in index.ts:473

extendRenewalDateForAllActiveSubscribers

extendRenewalDateForAllActiveSubscribers(
massExtendRenewalDateRequest: MassExtendRenewalDateRequest,
): Promise<MassExtendRenewalDateResponse>
Uses a subscription’s product identifier to extend the renewal date for all of its eligible active subscribers.
Parameters
- massExtendRenewalDateRequest: MassExtendRenewalDateRequest
  The request body for extending a subscription renewal date for all of its active subscribers.
Returns Promise<MassExtendRenewalDateResponse>
A response that indicates the server successfully received the subscription-renewal-date extension request.

Throws
APIException If a response was returned indicating the request could not be processed Extend Subscription Renewal Dates for All Active Subscribers
- Defined in index.ts:224

extendSubscriptionRenewalDate

extendSubscriptionRenewalDate(
originalTransactionId: string,
extendRenewalDateRequest: ExtendRenewalDateRequest,
): Promise<ExtendRenewalDateResponse>
Extends the renewal date of a customer’s active subscription using the original transaction identifier.
Parameters
- originalTransactionId: string
  The original transaction identifier of the subscription receiving a renewal date extension.
- extendRenewalDateRequest: ExtendRenewalDateRequest
  The request body containing subscription-renewal-extension data.
Returns Promise<ExtendRenewalDateResponse>
A response that indicates whether an individual renewal-date extension succeeded, and related details.

Throws
APIException If a response was returned indicating the request could not be processed Extend a Subscription Renewal Date
- Defined in index.ts:237

getAllSubscriptionStatuses

getAllSubscriptionStatuses(
transactionId: string,
status?: Status[] | undefined,
): Promise<StatusResponse>
Get the statuses for all of a customer’s auto-renewable subscriptions in your app.
Parameters
- transactionId: string
  The identifier of a transaction that belongs to the customer, and which may be an original transaction identifier.
- status: Status[] | undefined = undefined
  An optional filter that indicates the status of subscriptions to include in the response. Your query may specify more than one status query parameter.
Returns Promise<StatusResponse>
A response that contains status information for all of a customer’s auto-renewable subscriptions in your app.

Throws
APIException If a response was returned indicating the request could not be processed Get All Subscription Statuses
- Defined in index.ts:250

getAppTransactionInfo

getAppTransactionInfo(
transactionId: string,
): Promise<AppTransactionInfoResponse>
Get a customer's app transaction information for your app.
Parameters
- transactionId: string
  Any originalTransactionId, transactionId or appTransactionId that belongs to the customer for your app.
Returns Promise<AppTransactionInfoResponse>
A response that contains signed app transaction information for a customer.

Throws
APIException If a response was returned indicating the request could not be processed Get App Transaction Info
- Defined in index.ts:521

getImageList

getImageList(): Promise<GetImageListResponse>
Get the image identifier and state for all uploaded images.

Returns Promise<GetImageListResponse>
A response that contains status information for all images.

Throws
APIException If a response was returned indicating the request could not be processed Get Image List
- Defined in index.ts:450

getMessageList

getMessageList(): Promise<GetMessageListResponse>
Get the message identifier and state of all uploaded messages.

Returns Promise<GetMessageListResponse>
A response that contains status information for all messages.

Throws
APIException If a response was returned indicating the request could not be processed Get Message List
- Defined in index.ts:484

getNotificationHistory

getNotificationHistory(
paginationToken: string | null,
notificationHistoryRequest: NotificationHistoryRequest,
): Promise<NotificationHistoryResponse>
Get a list of notifications that the App Store server attempted to send to your server.
Parameters
- paginationToken: string | null
  An optional token you use to get the next set of up to 20 notification history records. All responses that have more records available include a paginationToken. Omit this parameter the first time you call this endpoint.
- notificationHistoryRequest: NotificationHistoryRequest
  The request body that includes the start and end dates, and optional query constraints.
Returns Promise<NotificationHistoryResponse>
A response that contains the App Store Server Notifications history for your app.

Throws
APIException If a response was returned indicating the request could not be processed Get Notification History
- Defined in index.ts:311

getRefundHistory

getRefundHistory(
transactionId: string,
revision: string | null,
): Promise<RefundHistoryResponse>
Get a paginated list of all of a customer’s refunded in-app purchases for your app.
Parameters
- transactionId: string
  The identifier of a transaction that belongs to the customer, and which may be an original transaction identifier.
- revision: string | null
  A token you provide to get the next set of up to 20 transactions. All responses include a revision token. Use the revision token from the previous RefundHistoryResponse.
Returns Promise<RefundHistoryResponse>
A response that contains status information for all of a customer’s auto-renewable subscriptions in your app.

Throws
APIException If a response was returned indicating the request could not be processed Get Refund History
- Defined in index.ts:268

getStatusOfSubscriptionRenewalDateExtensions

getStatusOfSubscriptionRenewalDateExtensions(
requestIdentifier: string,
productId: string,
): Promise<MassExtendRenewalDateStatusResponse>
Checks whether a renewal date extension request completed, and provides the final count of successful or failed extensions.
Parameters
- requestIdentifier: string
  The UUID that represents your request to the Extend Subscription Renewal Dates for All Active Subscribers endpoint.
- productId: string
  The product identifier of the auto-renewable subscription that you request a renewal-date extension for.
Returns Promise<MassExtendRenewalDateStatusResponse>
A response that indicates the current status of a request to extend the subscription renewal date to all eligible subscribers.

Throws
APIException If a response was returned indicating the request could not be processed Get Status of Subscription Renewal Date Extensions
- Defined in index.ts:286

getTestNotificationStatus

getTestNotificationStatus(
testNotificationToken: string,
): Promise<CheckTestNotificationResponse>
Check the status of the test App Store server notification sent to your server.
Parameters
- testNotificationToken: string
  The test notification token received from the Request a Test Notification endpoint
Returns Promise<CheckTestNotificationResponse>
A response that contains the contents of the test notification sent by the App Store server and the result from your server.

Throws
APIException If a response was returned indicating the request could not be processed Get Test Notification Status
- Defined in index.ts:298

getTransactionHistory

getTransactionHistory(
    transactionId: string,
    revision: string | null,
    transactionHistoryRequest: TransactionHistoryRequest,
    version?: GetTransactionHistoryVersion,
): Promise<HistoryResponse>
Get a customer’s in-app purchase transaction history for your app.
Parameters
- transactionId: string
  The identifier of a transaction that belongs to the customer, and which may be an original transaction identifier.
- revision: string | null
  A token you provide to get the next set of up to 20 transactions. All responses include a revision token. Note: For requests that use the revision token, include the same query parameters from the initial request. Use the revision token from the previous HistoryResponse.
- transactionHistoryRequest: TransactionHistoryRequest
- version: GetTransactionHistoryVersion = GetTransactionHistoryVersion.V1
  The version of the Get Transaction History endpoint to use. V2 is recommended.
Returns Promise<HistoryResponse>
A response that contains the customer’s transaction history for an app.

Throws
APIException If a response was returned indicating the request could not be processed Get Transaction History
- Defined in index.ts:329

getTransactionInfo

getTransactionInfo(transactionId: string): Promise<TransactionInfoResponse>
Get information about a single transaction for your app.
Parameters
- transactionId: string
  The identifier of a transaction that belongs to the customer, and which may be an original transaction identifier.
Returns Promise<TransactionInfoResponse>
A response that contains signed transaction information for a single transaction.

Throws
APIException If a response was returned indicating the request could not be processed Get Transaction Info
- Defined in index.ts:369

lookUpOrderId

lookUpOrderId(orderId: string): Promise<OrderLookupResponse>
Get a customer’s in-app purchases from a receipt using the order ID.
Parameters
- orderId: string
  The order ID for in-app purchases that belong to the customer.
Returns Promise<OrderLookupResponse>
A response that includes the order lookup status and an array of signed transactions for the in-app purchases in the order.

Throws
APIException If a response was returned indicating the request could not be processed Look Up Order ID
- Defined in index.ts:381

`Protected`makeFetchRequest

makeFetchRequest(
    path: string,
    parsedQueryParameters: URLSearchParams,
    method: string,
    requestBody: string | Buffer<ArrayBufferLike> | undefined,
    headers: { [key: string]: string },
): Promise<Response>
Parameters
- path: string
- parsedQueryParameters: URLSearchParams
- method: string
- requestBody: string | Buffer<ArrayBufferLike> | undefined
- headers: { [key: string]: string }
Returns Promise<Response>
- Defined in index.ts:208

`Protected`makeRequest

makeRequest<T>(
    path: string,
    method: string,
    queryParameters: { [key: string]: string[] },
    body: object | Buffer<ArrayBufferLike> | null,
    validator: Validator<T> | null,
    contentType?: string,
): Promise<T>
Type Parameters
- T
Parameters
- path: string
- method: string
- queryParameters: { [key: string]: string[] }
- body: object | Buffer<ArrayBufferLike> | null
- validator: Validator<T> | null
- OptionalcontentType: string
Returns Promise<T>
- Defined in index.ts:149

requestTestNotification

requestTestNotification(): Promise<SendTestNotificationResponse>
Ask App Store Server Notifications to send a test notification to your server.

Returns Promise<SendTestNotificationResponse>
A response that contains the test notification token.

Throws
APIException If a response was returned indicating the request could not be processed Request a Test Notification
- Defined in index.ts:392

sendConsumptionData

sendConsumptionData(
transactionId: string,
consumptionRequest: ConsumptionRequest,
): Promise<void>
Send consumption information about a consumable in-app purchase to the App Store after your server receives a consumption request notification.
Parameters
- transactionId: string
  The transaction identifier for which you’re providing consumption information. You receive this identifier in the CONSUMPTION_REQUEST notification the App Store sends to your server.
- consumptionRequest: ConsumptionRequest
  The request body containing consumption information.
Returns Promise<void>
Throws
APIException If a response was returned indicating the request could not be processed Send Consumption Information
- Defined in index.ts:404

setAppAccountToken

setAppAccountToken(
originalTransactionId: string,
updateAppAccountTokenRequest: UpdateAppAccountTokenRequest,
): Promise<void>
Sets the app account token value for a purchase the customer makes outside your app, or updates its value in an existing transaction.
Parameters
- originalTransactionId: string
  The original transaction identifier of the transaction to receive the app account token update.
- updateAppAccountTokenRequest: UpdateAppAccountTokenRequest
  The request body that contains a valid app account token value.
Returns Promise<void>
Throws
APIException If a response was returned indicating the request could not be processed. Set App Account Token
- Defined in index.ts:416

uploadImage

uploadImage(imageIdentifier: string, image: Buffer): Promise<void>
Upload an image to use for retention messaging.
Parameters
- imageIdentifier: string
  A UUID you provide to uniquely identify the image you upload. Must be lowercase.
- image: Buffer
  The image file to upload.
Returns Promise<void>
Throws
APIException If a response was returned indicating the request could not be processed Upload Image
- Defined in index.ts:428

uploadMessage

uploadMessage(
messageIdentifier: string,
uploadMessageRequestBody: UploadMessageRequestBody,
): Promise<void>
Upload a message to use for retention messaging.
Parameters
- messageIdentifier: string
  A UUID you provide to uniquely identify the message you upload. Must be lowercase.
- uploadMessageRequestBody: UploadMessageRequestBody
  The message text to upload.
Returns Promise<void>
Throws
APIException If a response was returned indicating the request could not be processed Upload Message
- Defined in index.ts:462

Class AppStoreServerAPIClient

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns AppStoreServerAPIClient

Methods

configureDefaultMessage

Parameters

Returns Promise<void>

Throws

deleteDefaultMessage

Parameters

Returns Promise<void>

Throws

deleteImage

Parameters

Returns Promise<void>

Throws

deleteMessage

Parameters

Returns Promise<void>

Throws

extendRenewalDateForAllActiveSubscribers

Parameters

Returns Promise<MassExtendRenewalDateResponse>

Throws

extendSubscriptionRenewalDate

Parameters

Returns Promise<ExtendRenewalDateResponse>

Throws

getAllSubscriptionStatuses

Parameters

Returns Promise<StatusResponse>

Throws

getAppTransactionInfo

Parameters

Returns Promise<AppTransactionInfoResponse>

Throws

getImageList

Returns Promise<GetImageListResponse>

Throws

getMessageList

Returns Promise<GetMessageListResponse>

Throws

getNotificationHistory

Parameters

Returns Promise<NotificationHistoryResponse>

Throws

getRefundHistory

Parameters

Returns Promise<RefundHistoryResponse>

Throws

getStatusOfSubscriptionRenewalDateExtensions

Parameters

Returns Promise<MassExtendRenewalDateStatusResponse>

Throws

getTestNotificationStatus

Parameters

Returns Promise<CheckTestNotificationResponse>

Throws

getTransactionHistory

Parameters

Returns Promise<HistoryResponse>

Throws

getTransactionInfo

Parameters

Returns Promise<TransactionInfoResponse>

Throws

lookUpOrderId

Parameters

Returns Promise<OrderLookupResponse>

Throws

ProtectedmakeFetchRequest

Parameters

Returns Promise<Response>

ProtectedmakeRequest

Type Parameters

`Protected`makeFetchRequest

`Protected`makeRequest