メインコンテンツまでスキップ

通知类型载荷

概览​

RTDN 载荷告知您的后端某次购买发生了哪些变化。本参考描述了每个通知所携带的字段，即 OneTimeProductNotification、SubscriptionNotification 和 VoidedPurchaseNotification，以及如何处理每一个。

OneTimeProductNotification​

OneTimeProductNotification 包含以下载荷：

{
  "version": String,
  "notificationType": Int,
  "purchaseToken": String,
  "sku": String
}

此载荷中的参数描述如下：

名称类型描述
versionString收到的载荷版本。
notificationTypeInt针对消耗型产品购买所收到的通知类型。可能的值可在此处查看。
purchaseTokenString消耗型购买的购买令牌。这是一个唯一值，应用于获取有关该购买的更多信息。
skuString购买中产品的 SKU。

NotificationType​

notificationType 的可能值如下：

值标题描述
1COMPLETED应用内购买已成功完成。
2CANCELED应用内购买已被取消。

处理 OneTimeProductNotification 载荷​

当您收到 OneTimeProductNotification 类型的通知时，请使用 orderId 参数获取有关该通知所关联购买的更多信息，然后用您所掌握的信息更新后端数据。

要使用 InApp 类型产品的 orderId 获取购买数据，请使用我们的应用内购买验证端点。

SubscriptionNotification​

SubscriptionNotification 包含以下载荷：

{
  "version": String,
  "notificationType": Int,
  "purchaseToken": String,
  "subscriptionId": String
}

此载荷中的参数描述如下：

名称类型描述
versionString收到的载荷版本。
notificationTypeInt针对订阅购买所收到的通知类型。可能的值可在此处查看。
purchaseTokenString订阅购买的购买令牌。这是一个唯一值，应用于获取有关该购买的更多信息。
subscriptionIdString购买中产品的 SKU。

NotificationType​

notificationType 的可能值如下：

值标题描述
2SUBSCRIPTION_RENEWED有效订阅已成功续订。
3SUBSCRIPTION_CANCELED订阅已被取消，可能是用户自愿取消，也可能是非自愿取消。对于自愿取消，此通知在用户发起取消时发送。
4SUBSCRIPTION_PURCHASED购买了新的订阅。
5SUBSCRIPTION_ON_HOLD订阅已被置于账户保留状态（如果启用了此功能）。
6SUBSCRIPTION_IN_GRACE_PERIOD由于付款失败等问题，订阅已进入宽限期（如果启用了此功能）。
7SUBSCRIPTION_RESTARTED用户通过 Aptoide Wallet > Settings > Manage Subscriptions 恢复了其订阅。该订阅曾被取消，但在恢复时仍处于其有效期内。
12SUBSCRIPTION_REVOKED订阅在其到期日之前被系统撤销。
13SUBSCRIPTION_EXPIRED订阅已到达其到期日且未续订。

处理 SubscriptionNotification 载荷​

当您收到 SubscriptionNotification 类型的通知时，请使用 orderId 参数获取有关该通知所关联购买的更多信息，然后用您所掌握的信息更新后端数据。

要使用订阅类型产品的 orderId 获取购买数据，请使用我们的订阅购买验证端点。

VoidedPurchaseNotification​

VoidedPurchaseNotification 包含以下载荷：

{
  "purchaseToken": String,
  "orderId": String,
  "productType": Int,
  "refundType": Int
}

此载荷中的参数描述如下：

名称类型描述
purchaseTokenString已作废购买的购买令牌。这是一个唯一值，应用于获取有关该购买的更多信息。
orderIdString在 Aptoide 内部使用的订单 UID（唯一标识符）。
productTypeInt已作废购买中 SKU 的类型。
refundTypeInt针对已作废购买所收到的通知类型。可能的值可在此处查看。

productType​

productType 的可能值如下：

值标题描述
1SUBS用于订阅的 SKU 类型。
2INAPP用于应用内产品的 SKU 类型。

refundType​

refundType 的可能值如下：

值标题描述
1REFUND_TYPE_FULL_REFUND购买已被全额退款。
2REFUND_TYPE_QUANTITY_BASED_PARTIAL_REFUND购买已被部分退款。

处理 VoidedPurchaseNotification 载荷​

当您收到 VoidedPurchaseNotification 类型的通知时，请使用 orderId 参数获取有关该通知所关联的已作废购买的更多信息，然后用您所掌握的信息更新后端数据。

要获取有关已作废购买本身的更多信息，请遵循我们关于应用内已作废购买集成的指南。

FAQ​

如何获取有关该购买的更多信息？​

要获取有关该购买的更多信息，请查看我们可用的 API，它们基于您可使用的信息提供完整内容。