转账 · PGSwift Docs

POST /api/transfer

请求

名称	类型	必填	描述
inquiry_id	string	true	要处理的查询标识符。

{
    "inquiry_id": "01jj1g751vqw68ng5546xnda5c"
}

响应

名称	描述
status	操作状态指示器。true 表示成功，false 表示失败。
code	机器可读的错误代码，仅在错误响应中出现。参见下方响应代码 — 请以此字段为准，不要依赖 `message`。
message	人类可读的描述文本，视情况出现。文案可能随时调整，恕不另行通知。
data	查询/转账的结果详情。始终存在：当没有可描述的查询时为 `null` — 即 `INQUIRY_NOT_FOUND`（404）以及内部错误（HTTP 200，`status:false`，附带 message）。
data.inquiry_id	提交的查询标识符。
data.merchant_transaction_id	与该查询关联的商户提供的标识符。
data.status	该查询的当前状态：`processing`、`pending`、`success` 或 `fail`。完整状态列表请参阅检查查询状态。
data.amount	转账金额，字符串格式，保留两位小数（例如 `"100000.00"`）。
data.reason	失败原因。仅在 `data.status` 为 `fail` 时出现。
data.payment_at	完成时间戳，服务器时间，`YYYY-MM-DD HH:MM:SS` 格式（例如 `"2026-08-13 09:12:45"`）。仅在 `data.status` 为 `success` 时出现。

响应代码

HTTP	code	场景	建议操作
200	—	转账已受理，处理中 `status: "processing"`	等待 Webhook 通知，或轮询检查查询状态
200	—	查询待审批 `status: "pending"`	请审批该查询 — 审批由您自行完成（也可由支持团队协助）
409	`DUPLICATE_TRANSFER`	该查询已被执行过 `status: "success"`（含 `payment_at`）或 `"processing"`	请勿重新发送。`data.status` 为该查询的当前状态；最终结果以 webhook 回调或 `/check/inquiry` 为准
409	`TRANSFER_ALREADY_FAILED`	该查询对应的转账已失败 `status: "fail"` + `reason`	使用全新的 `merchant_transaction_id` 创建新的查询
409	`INQUIRY_EXPIRED`	该查询已超过 30 分钟有效期 `status: "fail"`, `reason: "Inquiry expired"`	创建新的查询；预留资金将被退回
404	`INQUIRY_NOT_FOUND`	该账户下存在未知的 `inquiry_id` `null`	请核对该 ID；如需按 merchant_transaction_id 查找，可使用检查查询状态

两个端点全部错误 code 的完整列表，以及代码与字段稳定性约定，请参阅完整的错误代码参考。

{
    "status": true,
    "data": {
        "inquiry_id": "01jj1g751vqw68ng5546xnda5c",
        "merchant_transaction_id": "RP123333333",
        "status": "processing",
        "amount": "100000.00"
    }
}

{
    "status": false,
    "code": "DUPLICATE_TRANSFER",
    "message": "Transfer already submitted for this inquiry.",
    "data": {
        "inquiry_id": "01jj1g751vqw68ng5546xnda5c",
        "merchant_transaction_id": "RP123333333",
        "status": "success",
        "amount": "100000.00",
        "payment_at": "2026-08-13 09:12:45"
    }
}

{
    "status": false,
    "code": "TRANSFER_ALREADY_FAILED",
    "message": "Transfer for this inquiry already failed.",
    "data": {
        "inquiry_id": "01jj1g751vqw68ng5546xnda5c",
        "merchant_transaction_id": "RP123333333",
        "status": "fail",
        "amount": "100000.00",
        "reason": "Disbursement could not be processed, please contact support"
    }
}

{
    "status": false,
    "code": "INQUIRY_NOT_FOUND",
    "message": "Inquiry not found.",
    "data": null
}

安全重试

请以 code 字段为准，不要依赖 message — message 文案可能随时调整，恕不另行通知。新的 code 值可能会随时间推移而新增；请将无法识别的 code 视为一般性失败，并查看 data.status。

在原始转账的最终状态明确之前，切勿使用新的 merchant_transaction_id 创建新的查询 — 否则可能导致向同一收款人重复付款。

Webhook