获取订阅信息

如果计划在Web商店中销售订阅计划,请通过以下方式之一实现订阅操作信息的接收:

通过API调用进行设置

在应用程序的客户端侧,实现通过HTTP GET请求获取关于用户订阅的信息。

艾克索拉API使用HTTP访问认证。请求必须包含Authorization: Bearer <client_user_jwt>头,其中<client_user_jwt>是一个根据Base64编码的唯一令牌。获取方法:

将项目ID指定为路径参数projectId。可在发布商帐户中项目名称的旁边找到该参数。指定查询参数:

  • limit — 页面上元素数量的限制。(默认显示15个元素)。
  • offset — 元素编号,从该元素开始生成列表(从0开始数)。
  • locale — 界面语言(默认为英文)。接受符合ISO 639-1标准的值。

Copy
Full screen
Small screen
请求示例:
  'https://subscriptions.xsolla.com​/api/user/v1/projects/{projectId}/subscriptions?locale=ru&limit=5&offset=5 ' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer client_user_jwt'

Copy
Full screen
Small screen
响应示例:
{
  "items": [
    {
      "id": 13371337,
      "plan_id": 66053,
      "plan_external_id": "TestChangePlanBase",
      "plan_name": "package_recurrent_name_66053",
      "plan_description": "package_recurrent_description_66053",
      "product_id": null,
      "product_external_id": null,
      "product_name": null,
      "product_description": null,
      "status": "active",
      "date_create": "2021-03-11T13:50:11+03:00",
      "date_next_charge": "2031-04-11T13:51:02+03:00",
      "date_last_charge": "2021-03-11T13:51:02+03:00",
      "charge": {
        "amount": "0.2500",
        "currency": "USD"
      },
      "period": {
        "value": 5,
        "unit": "day"
      }
    }
  ],
  "has_more": true
}

通过Webhook进行设置

  1. 配置接收Webhook的参数:
    1. 发布商帐户中打开您的项目。
    2. 在侧边栏中单击项目设置
    3. 前往Webhooks部分。
    4. Webhooks开关设置为
    5. Webhook URL字段中指定接收Webhook的URL。
    6. 默认会生成一个给项目Webhook签名的密钥。如要生成一个新密钥,请单击刷新图标。
    7. 单击保存设置

  1. 在应用程序中实现对以下类型Webhook的处理:

  1. 测试Webhook:
    1. 在发布商帐户 > 项目设置 > Webhooks中,前往订阅选项卡。

    1. 要测试Webhook,请指定要包含在请求中向所提供Webhook URL发送的项目值(用户ID、发票ID)。如果没有真实值,可输入随意值。完成以下表单字段:
      • 用户ID
      • 艾克索拉发票ID
      • 金额
      • 货币
      • 计划ID
      • 订阅产品(可选)
      • 发票ID — 内部订单号(可选)
      • 试用期(要在沙盒模式下测试订阅支付或测试续订订阅计划,请将值设置为0。)

Note
在发布商帐户中,只能测试基本用户验证支付Webhook。

    1. 单击测试
    2. 验证收到了测试成功消息。如果测试成功,您的服务器须作出如下响应:
      • 不带消息正文的HTTP代码204。
      • 描述问题的HTTP代码400或500(如果指定用户未找到或传入的签名无效)。

  1. 测试接受剩余的Webhook:
    1. 使用沙盒模式测试购买和续订订阅及获取已创建订阅已更新订阅已取消订阅Webhook。
    2. 使用实时模式测试用真实支付购买订阅及获取退款已取消订阅Webhook。

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

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

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