Appearance
查询用户订阅
接口信息
GET /subscription/user/list请求参数
| 参数名 | 类型 | 必填 | 参与签名 | 说明 |
|---|---|---|---|---|
| userId | String | 是 | 是 | 用户 ID |
| merchantId | String | 是 | 是 | 商户号 |
| status | String | 否 | 是 | 订阅状态:ACTIVE / PAUSED / CANCELLED / FAILED / EXPIRED |
| sign | String | 是 | 否 | 签名 |
响应参数(data 数组元素)
| 字段 | 类型 | 说明 |
|---|---|---|
| subscriptionId | String | 订阅 ID |
| subscriptionCode | String | 订阅编号 |
| userId | String | 用户 ID |
| planId | String | 订阅计划 ID |
| planName | String | 计划名称 |
| amount | BigDecimal | 订阅金额 |
| currency | String | 货币 |
| status | String | 订阅状态 |
| nextBillingTime | String | 下次扣费时间 |
| startTime | String | 订阅开始时间 |
| endTime | String | 订阅结束时间 |
| cancelTime | String | 取消时间 |
| billingCount | Integer | 已扣费次数 |
| failedCount | Integer | 扣费失败次数 |
| createTime | String | 创建时间 |
请求示例
json
{
"userId": "USER_12345",
"merchantId": "MERCHANT_001",
"status": "ACTIVE",
"sign": "calculated_signature"
}响应示例
json
{
"rtn_code": "0000",
"success": true,
"data": [
{
"subscriptionId": "SUB_001",
"subscriptionCode": "SC_001",
"userId": "USER_12345",
"planId": "PLAN_MERCHANT001_20241021001",
"planName": "Basic Monthly Plan",
"amount": 9.99,
"currency": "USD",
"status": "ACTIVE",
"nextBillingTime": "2024-11-21 10:00:00",
"startTime": "2024-10-21 10:00:00",
"billingCount": 1,
"failedCount": 0,
"createTime": "2024-10-21 10:00:00"
}
]
}