**版本：202601**

# 查询周期性应用收费列表

**GET** `/openapi/2026-01/recurring_application_charges`

分页查询当前店铺的周期性应用收费列表。

## 请求

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

  每页记录数，默认 8
- `charges_status` string

  收费状态过滤：

  *   `pending`: 待处理
  *   `accepted`: 已接受
  *   `declined`: 已拒绝
  *   `active`: 激活中
  *   `expired`: 已过期
  *   `frozen`: 已冻结
  *   `cancelled`: 已取消
  *   `paid_failed`: 支付失败
  *   `paying`: 支付中

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `recurring_application_charges` object[]

    周期性应用收费列表

    *   Array \[

    - `id` string

      周期性应用收费 ID
    - `application_id` string

      应用 ID
    - `name` string

      向商家展示的收费名称
    - `price` string

      周期性收费金额
    - `capped_amount` string

      用量计费的封顶金额
    - `terms` string

      用量计费向商家展示的条款和条件文本
    - `return_url` string

      商家确认收费后返回的 URL
    - `confirmation_url` string

      用于跳转商家确认此次收费的 URL
    - `status` string

      周期性应用收费的当前状态
    - `trial_days` int32

      订阅提供的试用天数
    - `activated_on` string

      订阅激活日期
    - `trial_ends_on` string

      试用期结束日期
    - `billing_on` string

      下次账单日期
    - `cancelled_on` string

      收费取消日期
    - `cancel_sub_on` string

      订阅取消日期
    - `test` boolean

      是否为测试收费
    - `created_at` string

      创建时间，ISO-8601 格式
    - `updated_at` string

      最后更新时间，ISO-8601 格式
    - `charge_interval_days` int32

      收费间隔天数
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "recurring_application_charges": [
      {
        "id": "string",
        "application_id": "string",
        "name": "string",
        "price": "string",
        "capped_amount": "string",
        "terms": "string",
        "return_url": "string",
        "confirmation_url": "string",
        "status": "string",
        "trial_days": 0,
        "activated_on": "string",
        "trial_ends_on": "string",
        "billing_on": "string",
        "cancelled_on": "string",
        "cancel_sub_on": "string",
        "test": true,
        "created_at": "string",
        "updated_at": "string",
        "charge_interval_days": 0
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```