创建周期性应用收费

POST 
/openapi/2026-07/recurring_application_charges

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

请求

application/json

请求体

请求体必填

recurring_application_charge object必填

周期性应用收费

namestring必填

周期性应用收费名称

pricefloat必填

周期性应用收费的价格，必须与应用中定义的套餐价格一致

return_urlstring必填

完成订阅后将商家重定向到的 URL

trial_daysint32

订阅提供的试用天数

capped_amountstring

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

termsstring

用量计费的条款和条件，若提供了 capped_amount 则必填

testboolean

是否为测试收费（默认 false）

charge_interval_daysint32

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

示例

{
  "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

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

recurring_application_charge object

周期性应用收费

idstring

周期性应用收费 ID

application_idstring

应用 ID

namestring

向商家展示的收费名称

pricestring

周期性收费金额

capped_amountstring

用量计费的封顶金额

termsstring

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

return_urlstring

商家确认收费后返回的 URL

confirmation_urlstring

用于跳转商家确认此次收费的 URL

statusstring

周期性应用收费的当前状态

trial_daysint32

订阅提供的试用天数

activated_onstring

订阅激活日期

trial_ends_onstring

试用期结束日期

billing_onstring

下次账单日期

cancelled_onstring

收费取消日期

cancel_sub_onstring

订阅取消日期

testboolean

是否为测试收费

created_atstring

创建时间，ISO-8601 格式

updated_atstring

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

charge_interval_daysint32

收费间隔天数

示例

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