付款 API 使商户能够创建付款请求、执行资金转账并查询账户余额。
三步出款流程
| 步骤 | 端点 | 用途 |
|---|---|---|
| 1. 查询 | POST /api/inquiry |
验证目标银行账户并预留资金。返回 inquiry_id。30 分钟后过期。 |
| 2. 转账 | POST /api/transfer |
使用第 1 步返回的 inquiry_id 执行出款。true 响应表示已提交，而非已完成。 |
| 3. Webhook / 检查 | Webhook 或 POST /api/check/inquiry |
通过 disbursement.v2.completed、disbursement.v2.fail 或 disbursement.v2.expired 获取最终结果。 |
完整流程图请参阅集成流程。
错误代码
以下是付款 API 在两个端点中可能返回的所有错误 code：
| code | HTTP | 含义 | 建议操作 |
|---|---|---|---|
| 409 | 该查询已被执行 — 已成功，或仍在处理中 | 请勿重新发送。data.status 为当前状态；最终结果以 webhook 回调或 /check/inquiry 为准 |
| 409 | 该查询对应的转账已失败 | 使用新的 merchant_transaction_id 创建新的查询 |
| 404 | 该账户下 inquiry_id 未知或缺失 | 核实该 ID，或通过检查查询状态查找 |
| 409 | 该查询在转账前已超过 30 分钟有效期 | 创建新的查询；预留资金将自动退回 |
| 409 | 已有携带相同 merchant_transaction_id 的请求正在处理中 | 稍后重试即可获取已存储的查询 |
| 400 | bank_code 不是受支持的出款目标 | 使用附录中的有效代码后重新发送 |
| 400 | account_number 不是纯数字，或超过 30 位 | 修正账号后重新发送 |
| 403 | 您的账户尚未为该目标所属渠道开通出款 | 请联系支持团队；请勿重试 |