开始使用

集成过程

要集成订阅:

  1. 为您的游戏创建一个项目
  2. 设置订阅计划
  3. 设置身份认证
  4. 创建目录UI
  5. 打开支付UI
  6. 实现订阅信息的获取

运行机制

步骤1 — 获取用于打开支付UI的令牌

步骤2 — 购买

步骤3 — 支付

用户流程

词汇表

订阅计划
用户获得服务访问权限的一系列账单条件(账单金额、付款货币及扣款频率)。设置订阅计划为一项必需的集成步骤。
基于订阅的产品
用户购买订阅时向其提供的一个服务或一组服务。产品使用创建产品API调用来进行创建。如要为不同服务设置单独的订阅来进行销售或希望支持用户同时购买多个订阅,则必须创建产品。基于订阅的产品可以是对某个主播的频道、游戏或特殊商品/特殊能力的访问权限。关于设置和使用基于订阅的产品的更多信息,请参阅此说明

订阅

产品与所选计划的组合。订阅在用户选择一项订阅计划并获得某项服务的访问权限时创建。用户同时可获得的订阅数量取决于项目中的产品数量。订阅条件(账单周期、费用等)对应于所选计划的条件。如果计划条件在创建计划后发生更改,现有订阅的条件将保持不变。

示例1

产品:游戏的访问权限

  • 订阅计划Silver:10美元1月
  • 订阅计划Gold:100美元1年

用户可以选择以下订阅之一:

  • 订阅1:通过10美元/月的订阅计划访问游戏
  • 订阅2:通过100美元/年的订阅计划访问游戏

示例2

产品1:游戏1的访问权限

产品2:游戏2的访问权限

  • 订阅计划:10美元1月

用户可以同时拥有两个订阅:

  • 订阅1:通过10美元/月的订阅计划访问游戏1
  • 订阅2:通过10美元/月的订阅计划访问游戏2

注:
如果未设置基于订阅的产品,则用户一次只能拥有一个订阅。如要允许同时拥有多个订阅,则您需要设置产品。
订阅计划组

具有相同group_id参数值的一组计划。 要创建或修改一个组,请将group_id参数传入API调用:

如要实现以下目的,则必须创建计划组:

  • 创建一个基于订阅的产品

  • 限制订阅某个产品时可选择的计划数量

  • 让用户可以在组内的计划间切换

关于设置和使用组的更多信息,请参阅此说明

试用期
用户在不付费的情况下可试用某个订阅的期限。 功能:
  • 购买了有试用期的订阅后,会创建一个账单帐户并会进行一次授权支付,即向用户帐户进行一笔小额扣款然后退还。扣款时,不会向Webhook URL发送支付Webhook。
  • 试用期结束后,将全额扣取订阅费用,并向Webhook URL发送“付款”和“已更新订阅”Webhook。如果订阅支付不成功,则会发送“已取消订阅”Webhook。试用期不包括在计划有效期内,而是单独计算期限。
  • 可将试用期添加为促销活动奖励。
  • 宽限期
    宽限期是用户在订阅到期后仍能访问游戏的一段时间。功能如下:
    • 宽限期只适用于一次性付款类型的订阅。自动续订类型的订阅将自动扣费。
    • 您可以在发布商帐户中更改宽限期的长短。
    • 系统会每天发送付款提醒直至用户支付订阅费或宽限期结束。
    • 用户需支付完整的订阅价格。用户在宽限期用掉的天数将从主账单周期中减除,因为这些天数已包含在主订阅中。
    • 如果某计划设置的宽限期字段值为0,则该计划没有宽限期。
    重试期限
    尝试向保存的支付帐户扣款的期限。此配置仅适用于自动续订类型的订阅,并在扣费失败时激活。功能如下:
    • 系统每天尝试一次从付款帐户中扣费。
    • 系统将一直尝试扣费直至订阅被手动续订、被用户取消,或在超过账单扣费重试次数后取消。
    • 如果激活了此设置,用户在超过账单扣费重试次数之前一直拥有订阅的访问权限。
    • 如果用户手动续订了订阅,则系统尝试扣费花掉的天数(一天一次尝试)将从主账单周期中减除,因为这些天数已包含在主订阅中。
    自动付款
    自动向保存的账单帐户扣费的续订类型,用户不需要进行操作。如果未保存账单帐户,则自动付款类型的订阅将切换为Non renewing状态。
    一次性付款
    用户点击邮件中收到的支付链接进行扣费的续订类型。如果用户选择了不支持自动付款的支付方式,则使用此方式。

    订阅状态

    一个订阅应处于以下状态之一:

    • 活动。主要状态。订阅会在首次成功付款后创建并激活。只有活动订阅才可能进行未来扣款。

    注意
    不能使用API手动创建订阅——订阅只能在购买时自动创建。

    • 已取消。订阅已由于以下原因之一被立即取消:
      • 通过API方法或在艾克索拉发布商帐户中更改了状态。
      • 已被用户取消。
      • 已到期(如果参数中设置了到期日)。
      • 超过最大扣款尝试次数。默认为三次,如需更改默认值,请联系帐户经理。
      • 无法在游戏中找到该用户。
      • 用户帐户已删除。

    注:
    如果取消订阅,可针对上一笔付款发起退款。该选项对合作伙伴和用户均可用。

    • 未续订。已取消续订。状态更改为“已取消”前,订阅将持续到当前付款周期结束。以下任一原因均可导致续订被取消:
      • 通过API方法或在发布商帐户中更改了状态。
      • 用户通过邮件链接进行了取消。
      • 用户帐户已删除。

    您的进度
    感谢您的反馈!
    上次更新时间: 2021年12月29日

    发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

    报告问题
    我们非常重视内容质量。您的反馈将帮助我们做得更好。
    请留下邮箱以便我们后续跟进
    感谢您的反馈!