开始使用

集成过程

要集成订阅:

  1. 注册艾克索拉发布商帐户
  2. 设置订阅计划
  3. 设置Webhook
  4. 获取令牌
  5. 配置UI打开过程

运行机制

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

步骤2 — 购买

步骤3 — 支付

用户流程

词汇表

订阅计划
用户获得服务访问权限的一系列账单条件(账单金额、付款货币及扣款频率)。设置订阅计划为一项必需的集成步骤。
基于订阅的产品
用户购买订阅后向其提供的一个或一组服务。如果为不同服务设置了单独的订阅计划或希望允许用户同时订阅多个计划,则必须创建产品。订阅产品的示例之一是视频主播或圈内达人频道。

订阅

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

示例1

产品:游戏的访问权限

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

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

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

示例2

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

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

  • 订阅计划:10美元1月

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

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

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

    订阅状态

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

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

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

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

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

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

    本文对您的有帮助吗?
    谢谢!
    我们还有其他可改进之处吗? 留言
    非常抱歉
    请说明为何本文没有帮助到您。 留言
    感谢您的反馈!
    我们会查看您的留言并运用它改进用户体验。
    为此页面评分
    为此页面评分
    我们还有其他可改进之处吗?

    不想回答

    感谢您的反馈!

    继续阅读

    上次更新时间: 2021年3月23日

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

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