开始使用

集成过程

要集成订阅:

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

运行机制

购买订阅

自动续订周期性订阅

用户流程

词汇表

订阅计划
用户获得服务访问权限的一系列账单条件(账单金额、付款货币及扣款频率)。设置订阅计划为一项必需的集成步骤。
基于订阅的产品
用户购买订阅时向其提供的一个服务或一组服务。产品使用创建产品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,则该计划没有宽限期。
关于设置宽限期的更多信息,请参阅说明
重试期限
从保存的支付帐户中尝试扣款的期限。在该期限中,用户仍可继续使用订阅服务。该期限在扣款失败时激活。功能:
  • 重试期限只适用于定期计划自动付款订阅类型。
  • 从保存的支付帐户中扣款的尝试每日进行一次。
  • 系统在续订成功、订阅被用户取消或超过扣款尝试次数限制之前将一直尝试扣款。
  • 如用户在重试期限结束前续订成功,则用户在未付款的情况下对合作伙伴服务的访问天数将从订阅期总天数中减去。
  • 如计划设置中账单扣费重试次数字段的值为0,则该计划没有重试期限。
关于设置重试期限的更多信息,请参阅说明
自动付款
自动向保存的账单帐户扣费的续订类型,用户不需要进行操作。如果未保存账单帐户,则自动付款类型的订阅将切换为Non renewing状态。
一次性付款
用户点击邮件中收到的支付链接进行扣费的续订类型。如果用户选择了不支持自动付款的支付方式,则使用此方式。

订阅状态

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

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

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

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

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

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

您的进度
感谢您的反馈!
上次更新时间: 2023年11月24日

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

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