POST/v1/billing/recharge

创建充值订单

请求体需要金额与支付方式，支付方式当前支持 `ALIPAY` 与 `WECHAT`。

基础信息

鉴权	Authorization: Bearer 管理 token
请求类型	application/json
响应类型	application/json

请求参数

Body

字段

类型

必填

位置

说明

amount

number

是

body

充值金额，必须大于 0。

示例：200

payMethod

string

是

body

支付方式：ALIPAY / WECHAT。

示例："ALIPAY"

请求示例

json

{
  "amount": 200,
  "payMethod": "ALIPAY"
}

响应示例

json

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "orderNo": "RC202604130001",
    "qrCodeUrl": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
    "payMethod": "ALIPAY",
    "payStatus": "WAIT_PAY"
  }
}

错误码

HTTP	code	说明
401	`unauthorized`	管理开放 API 鉴权失败。
400	`validation_error`	请求参数格式错误或取值不满足约束。
404	`not_found`	目标资源不存在或不属于当前商户。

在线调试

Playground · 浏览器直连网关

创建充值订单

创建支付宝或微信充值订单。

Base URL Token / API Key

JSON 请求体

json

尚未发起请求。

bash

curl --location --request POST 'https://api.harnmodel.com/v1/billing/recharge' \
  --header 'Authorization: Bearer mgmt-token-xxx' \
  --header 'Content-Type: application/json' \
  --data '{}'

多语言示例

bash

curl --location --request POST 'https://api.harnmodel.com/v1/billing/recharge' \
  --header 'Authorization: Bearer mgmt-token-xxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 200,
    "payMethod": "ALIPAY"
  }'