Skip to content

查询用户订阅

接口信息

GET /subscription/user/list

请求参数

参数名类型必填参与签名说明
userIdString用户 ID
merchantIdString商户号
statusString订阅状态:ACTIVE / PAUSED / CANCELLED / FAILED / EXPIRED
signString签名

响应参数(data 数组元素)

字段类型说明
subscriptionIdString订阅 ID
subscriptionCodeString订阅编号
userIdString用户 ID
planIdString订阅计划 ID
planNameString计划名称
amountBigDecimal订阅金额
currencyString货币
statusString订阅状态
nextBillingTimeString下次扣费时间
startTimeString订阅开始时间
endTimeString订阅结束时间
cancelTimeString取消时间
billingCountInteger已扣费次数
failedCountInteger扣费失败次数
createTimeString创建时间

请求示例

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"
    }
  ]
}

Codrimpay