發起在線支付 - BearLab AI

請求頭

請求頭	必填	說明
`Authorization`	✓	`Bearer YOUR_ACCESS_TOKEN`，帳號訪問令牌
`Content-Type`	✓	`application/json`

介面：POST /api/user/pay 建立一筆待支付充值訂單，並向易支付網關拉起支付，回傳網關提交地址 url 與表單參數 data。前端將 data 以表單 POST 到 url 即可跳轉收銀台。支付完成後網關回調 /api/user/epay/notify 入賬。

請求體

欄位	類型	必填	說明
`amount`	integer	✓	充值額度數量，須 ≥ `min_topup`
`payment_method`	string	✓	支付方式識別碼，取自 `topup/info` 的 `pay_methods[].type`，例如 `alipay`、`wxpay`

curl "https://bearlab.ai/api/user/pay" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 100, "payment_method": "alipay" }'

Success

{
  "message": "success",
  "url": "https://YOUR_PAY_GATEWAY/submit.php",
  "data": {
    "pid": "1000",
    "out_trade_no": "USR42NOa1b2c31718000000",
    "name": "TUC100",
    "money": "95.00",
    "type": "alipay",
    "sign": "e10adc3949ba59abbe56e057f20f883e",
    "sign_type": "MD5"
  }
}

Failed

{
  "message": "error",
  "data": "支付方式不存在"
}

欄位	類型	說明
`message`	string	`success` / `error`
`url`	string	易支付網關提交地址，成功時回傳
`data`	object	提交給網關的表單參數（含 `out_trade_no` 商戶訂單號、`money` 實付金額、`sign` 簽名等），隨網關而異

可能的 error 文案：參數錯誤、充值數量不能小於 N、取得使用者分組失敗、充值金額過低、支付方式不存在、當前管理員未設定支付資訊、拉起支付失敗、建立訂單失敗。