**版本：202601**

# 创建周期性应用收费

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

使用提供的详情创建新的周期性应用收费。

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `recurring_application_charge` object (required)

  周期性应用收费

  - `name` string (required)

    周期性应用收费名称
  - `price` float (required)

    周期性应用收费的价格，必须与应用中定义的套餐价格一致
  - `return_url` string (required)

    完成订阅后将商家重定向到的 URL
  - `trial_days` int32

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

    商家在用量计费下可被收取的封顶金额。若提供此字段，terms 字段也必须提供
  - `terms` string

    用量计费的条款和条件，若提供了 capped\_amount 则必填
  - `test` boolean

    是否为测试收费（默认 false）
  - `charge_interval_days` int32

    收费间隔天数，默认 30，范围 1-365

```json
{
  "recurring_application_charge": {
    "name": "string",
    "price": 0,
    "return_url": "string",
    "trial_days": 0,
    "capped_amount": "string",
    "terms": "string",
    "test": true,
    "charge_interval_days": 0
  }
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `recurring_application_charge` object

    周期性应用收费

    - `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

      收费间隔天数

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "recurring_application_charge": {
      "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
    }
  }
}
```