管理用户订阅

要在应用程序中实现订阅管理,请按以下逻辑操作:

  1. 检索用户的订阅列表并在应用程序中显示。
  2. 实现订阅管理 — 打开订阅者帐户或直接从应用程序管理具体订阅。

简化实现可参考示例代码

注:

仅已认证用户可购买和管理订阅。关于使用SDK进行用户身份认证,请参阅身份认证部分。

代码示例中使用用户名和密码进行密码身份认证(XsollaAuth.SignIn方法),并采用硬编码凭据以简化订阅工作流程演示。实际应用中,您需要使用XsollaAuth.AuthBySavedToken方法实现完整的身份认证逻辑和当前会话验证。

检索用户订阅

使用XsollaSubscriptions.GetSubscriptions方法检索当前用户的所有活跃订阅。该方法返回与当前用户帐户关联且状态为activenon_renewingfreeze的订阅。

也可使用XsollaSubscriptions.GetSubscriptionDetails方法请求每个订阅的详细信息。

使用返回的数据(SubscriptionItem对象)在应用程序中显示订阅管理UI。

配置UI小组件的关键字段:

  • plan_name — 订阅名称。
  • status — 当前订阅状态(newactivecancelednon_renewingfreeze)。
  • date_next_charge — 下次自动扣费的日期和时间。
  • charge — 定期付款信息,包含价格(amount)和货币(currency)。

订阅管理

注意
要处理订阅变更和取消,需实现Webhook处理。关于配置和测试Webhook的详细信息,请参阅获取订阅信息部分。

打开订阅者帐户

艾克索拉提供现成的订阅者帐户UI,用户可通过它查看订阅信息并进行管理。这是实现订阅管理最简单且推荐的方式。

主要功能:

  • 查看订阅详情
  • 管理订阅 — 立即取消、禁用自动续订或重新激活(取决于项目设置)
  • 变更订阅计划
  • 更新支付方式

调用XsollaSubscriptions.GetUserAccountUrl方法向用户显示订阅者帐户。请求成功后,包含帐户UI链接的UserAccountLink对象将被传入回调函数。请使用XsollaWebBrowser.Open方法在外部浏览器或内置WebView中打开该链接。

具体订阅管理

使用XsollaSubscriptions.GetSubscriptionManagementUrl方法从应用程序打开具体订阅的管理UI。请求成功后,包含订阅管理UI链接的PaymentLink对象将被传入回调函数。请使用XsollaWebBrowser.Open方法在外部浏览器或内置WebView中打开该链接。

订阅取消

使用XsollaSubscriptions.CancelSubscription方法从应用程序UI实现订阅取消。该方法禁用自动续订,订阅转为non_renewing状态。这意味着下一计费周期不会自动扣费;订阅在已付费期间结束前保持有效。

订阅续期

使用XsollaSubscriptions.GetSubscriptionRenewalUrl方法实现从应用程序导航到订阅续期UI。请求成功后,包含订阅续期UI链接的PaymentLink对象将被传入回调函数。请使用XsollaWebBrowser.Open方法在外部浏览器或内置WebView中打开该链接。

本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2026年4月14日

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

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!
无法发送您的反馈
请稍后重试或发送邮件至doc_feedback@xsolla.com与我们联系。