订阅者帐户

运行机制

订阅者帐户是一项服务，让用户能够查看并管理您艾克索拉项目中配置的所有订阅。

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

• 点击艾克索拉订阅相关邮件通知中的链接
• 从游戏内支付页面访问

• 使用服务器侧API调用
• 使用客户端侧API调用

通过API获取订阅者帐户链接

服务器侧调用

该调用允许您通过HTTP POST请求从应用程序的服务器侧实现订阅者帐户链接的生成。

URL地址：

https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account

授权：

该调用使用基本认证。所有对API的请求必须包含Authorization: Basic <your_authorization_basic_key>头，其中<your_authorization_basic_key>是根据Base64标准编码的merchant_id:api_key对。 前往发布商帐户查找以下参数：

• merchant_id在以下位置显示：
  • 公司设置 > 公司部分。
  • 在发布商帐户任意页面的浏览器地址栏的URL中。URL的格式如下：https://publisher.xsolla.com/<merchant_id>。
• api_key仅在创建它时在发布商帐户中显示一次，必须存储在己侧。您可以在以下部分创建新的密钥：
  • 公司设置 > API密钥
  • 项目设置 > API密钥

参数：

指定project_id作为路径参数 — 项目ID，在发布商帐户中的项目名称旁边或项目任何页面的浏览器地址栏中显示。URL格式如下：https://publisher.xsolla.com/<merchantId>/projects/<projectId>。

正文参数：

 1curl -v https://subscriptions.xsolla.com​/api/v1/projects/{projectId}/subscriptions/user_account \
 2-X POST \
 3-u your_merchant_id:merchant_api_key \
 4-H 'Content-Type:application/json' \
 5-H 'Accept: application/json' \
 6-d '
 7{
 8  "user_v1": "user123",
 9  "locale": "en"
10}'

响应示例：

1{
2  "redirect_url": "https://subscriptions-user-account.xsolla.com/?token=<access_token>&projectId=<project_id>&merchantId=<merchant_id>&locale=<locale>"
3}

客户端侧调用

如果项目设置了艾克索拉登录管理器，该调用允许您通过HTTP GET请求从应用程序的客户端侧实现订阅者帐户链接的生成。

URL地址：

https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account

授权：

请求必须包含Authorization: Bearer <client_user_jwt>头，其中<client_user_jwt>是用户的JSON Web令牌（JWT），它是一个根据Base64标准编码的Base64编码令牌。要获取该令牌：

• 如应用程序使用用户名和密码认证，请使用Register new user和Auth by username and password API调用。
• 如应用程序使用通过社交网络认证，请使用Auth via social network API调用。

参数：

指定project_id作为路径参数 — 项目ID，在发布商帐户中的项目名称旁边或项目任何页面的浏览器地址栏中显示。URL格式如下：https://publisher.xsolla.com/{merchantId}/projects/{projectId}。

指定locale作为查询参数 — 界面语言使用符合ISO 639-1标准的两位小写字母表示。如果未传递此参数，则语言将根据用户的IP地址确定。如果传递的地理位置不在艾克索拉列表中，则默认使用英语。

请求示例：

1curl -v https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account \
2-X GET \
3-u your_merchant_id:merchant_api_key \
4-H 'Content-Type:application/json' \
5-H 'Accept: application/json' \

响应示例：

1{
2  "redirect_url": "https://subscriptions-user-account.xsolla.com/?token=<access_token>&projectId=<project_id>&merchantId=<merchant_id>&locale=<locale>"
3}