跳转到内容
/
List plans by product (no...

Subscriptions API (2.0)

概览

  • Version: 2.0
  • 服务器：https://api.xsolla.com/merchant/v2/

本API参考介绍管理订阅、优惠券和促销活动的端点。 如需了解关于订阅的详细信息，请参考产品指南和词汇表。

下载 OpenAPI 描述
index.json
index.yaml
语言
服务器
Mock server
https://xsolla.redocly.app/_mock/zh/api/subscriptions/

令牌

操作

计划

操作

产品

操作

订阅

操作

支付

操作

促销活动

操作

优惠券

操作

订阅

操作

Catalog

操作

List products (no auth)

请求

路径
project_idinteger\d+必需
查询
limitinteger
offsetinteger
localestring
curl -i -X GET \
  'https://xsolla.redocly.app/_mock/zh/api/subscriptions/api/public/v1/projects/{project_id}/products?limit=0&offset=0&locale=string'

响应

Subscription's products

正文application/json
has_moreboolean必需
示例: false
itemsArray of objects
默认值 []
items[].​product_descriptionstring or null
示例: "Localized product description"
items[].​product_external_idstring or null
示例: "ProductExternalId"
items[].​product_group_idstring or null
示例: "TestGroupId"
items[].​product_idinteger必需
示例: "12345"
items[].​product_namestring必需
示例: "Product name"
响应
application/json
{
  "has_more": false,
  "items": []
}

List plans by product (no auth)

请求

路径
project_idinteger\d+必需
productIdstring必需
查询
plan_idArray of integers
plan_external_idArray of strings
limitinteger
offsetinteger
localestring
countrystring
curl -i -X GET \
  'https://xsolla.redocly.app/_mock/zh/api/subscriptions/api/public/v1/projects/{project_id}/products/{productId}/user_plans?plan_id=0&plan_external_id=string&limit=0&offset=0&locale=string&country=string'

响应

Subscription's plans by product

正文application/json
has_moreboolean必需
示例: "false"
itemsArray of objects
默认值 []
items[].​chargeobject必需
items[].​charge.​amountnumber(float)必需
示例: 4.99
items[].​charge.​currencystring必需
示例: "USD"
items[].​charge.​setup_feenumber(float)必需
示例: 0.99
items[].​periodobject必需
items[].​period.​unitstring or null
默认值 null
示例: "month"
items[].​period.​valueinteger or null
默认值 null
示例: "1"
items[].​plan_descriptionstring必需
示例: "Localized plan description"
items[].​plan_end_datestring or null(date-time)
示例: "2031-04-11T13:51:02+03:00"
items[].​plan_external_idstring必需
示例: "PlanExternalId"
items[].​plan_group_idstring or null
示例: "TestGroupId"
items[].​plan_idinteger必需
示例: "54321"
items[].​plan_namestring必需
示例: "Localized plan name"
items[].​plan_start_datestring or null(date-time)
示例: "2021-04-11T13:51:02+03:00"
items[].​plan_typestring必需
示例: "all"
items[].​promotionobject必需
items[].​promotion.​promotion_charge_amountnumber or null(float)
默认值 null
示例: "3.99"
items[].​promotion.​promotion_remaining_chargesinteger or null
默认值 null
示例: "3"
items[].​trial_periodinteger or null
示例: "7"
响应
application/json
{
  "has_more": "false",
  "items": []
}

List plans (no auth)

请求

路径
project_idinteger\d+必需
查询
plan_idArray of integers
plan_external_idArray of strings
limitinteger
offsetinteger
localestring
countrystring
curl -i -X GET \
  'https://xsolla.redocly.app/_mock/zh/api/subscriptions/api/public/v1/projects/{project_id}/user_plans?plan_id=0&plan_external_id=string&limit=0&offset=0&locale=string&country=string'

响应

Subscription's default plans

正文application/json
has_moreboolean必需
示例: "false"
itemsArray of objects
默认值 []
items[].​chargeobject必需
items[].​charge.​amountnumber(float)必需
示例: 4.99
items[].​charge.​currencystring必需
示例: "USD"
items[].​charge.​setup_feenumber(float)必需
示例: 0.99
items[].​periodobject必需
items[].​period.​unitstring or null
默认值 null
示例: "month"
items[].​period.​valueinteger or null
默认值 null
示例: "1"
items[].​plan_descriptionstring必需
示例: "Localized plan description"
items[].​plan_end_datestring or null(date-time)
示例: "2031-04-11T13:51:02+03:00"
items[].​plan_external_idstring必需
示例: "PlanExternalId"
items[].​plan_group_idstring or null
示例: "TestGroupId"
items[].​plan_idinteger必需
示例: "54321"
items[].​plan_namestring必需
示例: "Localized plan name"
items[].​plan_start_datestring or null(date-time)
示例: "2021-04-11T13:51:02+03:00"
items[].​plan_typestring必需
示例: "all"
items[].​promotionobject必需
items[].​promotion.​promotion_charge_amountnumber or null(float)
默认值 null
示例: "3.99"
items[].​promotion.​promotion_remaining_chargesinteger or null
默认值 null
示例: "3"
items[].​trial_periodinteger or null
示例: "7"
响应
application/json
{
  "has_more": "false",
  "items": []
}

优惠券

操作

订阅

操作

Payment accounts

操作