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

应用内无效购买验证

我们的服务提供对无效购买 (Voided Purchases) 的访问，其中包括被用户取消或由于支付处理过程中出现意外问题而产生的交易。正确集成无效购买有助于向用户提供有关其购买的最新且准确的信息，从而确保无缝体验。

本指南将逐步介绍将无效购买集成到您的应用中所需的步骤，并提供有关如何高效且安全地处理它们的提示。

为什么无效购买很重要​

有效处理无效购买可通过以下方式改善用户体验：

  • 防止在购买被无效后（例如退款、取消）访问高级内容。
  • 在您的应用、后端和用户帐户之间保持购买记录同步。
  • 遵守商店政策以避免潜在问题。

什么是无效购买？​

无效购买是指已被 Aptoide Connect 或用户退款或退单的交易。这些可能包括：

  • Aptoide Connect 发出的退款。
  • 已取消的订阅或应用内购买。
  • 受支付错误影响的交易。

无效购买集成指南​

要正确集成无效购买功能，请遵循以下最佳做法：

1. 管理无效购买的后端 API​

  • 实现一个后端 API 来管理每个用户已处理的无效购买。这对于确保用户不会收到有关其无效购买的重复通知或警告至关重要。

2. 通知用户无效购买​

  • 在购买被无效时，显示清晰友好的消息告知用户。避免使用技术术语，并为用户提供有用的上下文。
  • 示例消息："您最近的购买已被取消，对高级功能的访问权限已被撤销。"

3. 更新本地和后端购买记录​

  • 在本地数据库和您的后端中将任何无效购买标记为已无效 (voided)，以避免购买历史记录中的差异。
  • 撤销对与无效购买相关联的任何高级内容、订阅或功能的访问权限。
  • 确保在本地和服务器上都更新购买状态，以避免无意中让用户访问高级内容。

4. 订阅专属处理​

  • 对于订阅，请仅在订阅到期日期之后撤销访问权限，而不是在无效时立即撤销。这可确保拥有合法的、部分使用过的订阅的用户不会过早受到处罚。

实现​

要获取您应用程序的无效购买，请按照以下步骤操作：

  1. 向我们的服务请求无效购买。
    1. 正确使用提供的查询参数以避免接收已处理的数据。
  2. 使用 VoidedPurchase 模型中的 orderId 参数将无效购买与用户关联。
  3. 将收到的无效购买的状态通知用户。

接下来介绍将无效购买服务与您的 API 集成。

1. 请求无效购买​

要请求您应用程序的无效购买，请遵循我们的无效购买端点。

实现无效购买请求​

import requests

package_name = "com.example.app"
void_purchases_url = f"https://api.catappult.io/productv2/8.20240101/google/inapp/v3/applications/{package_name}/purchases/voidedpurchases"
response = requests.get(void_purchases_url)
response = response.json()
for voided_purchase in response["voidedPurchases"]:
    order_id = voided_purchase["orderId"]
    print(f"Handling voided purchase with order id {order_id}")
    # Handle your voided purchase here

2. 处理收到的无效购买​

从服务收到结果后，您可以应用您的自定义业务逻辑。

3. 将无效购买通知用户​

关联无效购买后，将支付状态通知用户。

常见问题​

我可以从此 API 接收哪些可能的值？​

您可以在端点文档中浏览可用数据。