PurchasingService

提供用于与亚马逊应用商店购买框架交互的主API。

构造函数

new PurchasingService()

new PurchasingService(): PurchasingService

返回值

PurchasingService

方法

getProductData()

static getProductData(productDataRequest): Promise<ProductDataResponse>

发起检索多达一百个SKU的商品数据的请求。

用法模式 1) getProductData通常在产品页面启动时调用，用于获取并显示一组SKU对应的IAP应产品信息（如价格）。

要简化此流程，请利用此程序包中提供的useIapProductData挂钩。在产品页面组件中调用此挂钩，即可在产品页面启动时自动触发getPurchaseUpdates API。

2) 除此产品页面用例外，您的应用可能还有与IAP产品相关的特定用例。这些特定场景可使用getProductData API。

参数

productDataRequest

ProductDataRequest

输入参数。

返回值

Promise<ProductDataResponse>

• 包含产品数据和请求状态的响应。

---

getPurchaseUpdates()

static getPurchaseUpdates(purchaseUpdatesRequest): Promise<PurchaseUpdatesResponse>

发起请求以检索客户已购买和/或取消的商品的更新信息。

用法模式 1) 为确保获取最新购买资讯，亚马逊建议在应用主屏幕启动时以及应用从后台切换到前台 (BG -> FG) 时调用getPurchaseUpdates API。

要简化此流程，请利用此程序包中提供的usePurchaseUpdates挂钩。在主屏幕组件中调用此挂钩，当主屏幕启动或应用程序进行BG -> FG切换时，将自动触发getPurchaseUpdates API。

2) 除此主屏幕用例外，您的应用可能还有与购买相关的特定用例。这些特定场景可使用getPurchaseUpdates API。

参数

purchaseUpdatesRequest

PurchaseUpdatesRequest

输入参数。

返回值

Promise<PurchaseUpdatesResponse>

• 包含收据数据和请求状态的响应。

---

getUserData()

static getUserData(userDataRequest): Promise<UserDataResponse>

发起检索当前登录用户的用户ID的请求。

用法模式 1) 为确保检索当前用户账户的收据，亚马逊建议在应用程序主屏幕启动以及应用程序从后台切换到前台 (BG->FG) 时调用getUserData API。

要简化此流程，请利用此程序包中提供的useUserData挂钩。在主屏幕组件中调用此挂钩，当主屏幕启动或应用程序进行 BG->FG 切换时，将自动触发getUserData API。

2) 除此主屏幕用例外，您的应用可能还有与user-id相关的特定用例。这些特定场景可使用getUserData API。

参数

userDataRequest

UserDataRequest

输入参数。

返回值

Promise<UserDataResponse>

• 包含用户数据和响应代码的响应。

---

modifySubscription()

static modifySubscription(modifySubsRequest): Promise<ModifySubscriptionResponse>

发起针对订阅的modifySubscription请求。

参数

modifySubsRequest

ModifySubscriptionRequest

用于修改订阅的输入参数。

返回值

Promise<ModifySubscriptionResponse>

• 包含收据数据列表（如果成功）和请求状态的响应。

---

notifyFulfillment()

static notifyFulfillment(notifyFulfillmentRequest): Promise<NotifyFulfillmentResponse>

将有关购买履行的信息通知亚马逊。

参数

notifyFulfillmentRequest

NotifyFulfillmentRequest

输入参数。

返回值

Promise<NotifyFulfillmentResponse>

• 包含通知履行请求状态的响应。

---

purchase()

static purchase(purchaseRequest): Promise<PurchaseResponse>

发起产品的购买流程。

参数

purchaseRequest

PurchaseRequest

购买的输入参数。

返回值

Promise<PurchaseResponse>

• 包含收据数据和请求状态的响应。

---

requestUserProfileAccess()

static requestUserProfileAccess(): Promise<UserProfileAccessResponse>

发起请求，对用户配置文件访问权限检索验证码

返回值

Promise<UserProfileAccessResponse>

• 包含用户配置文件访问权限验证码和响应代码的响应。

---

Last updated: 2025年10月2日