POST
通过收款方ID发起打款
使用已审核通过的收款人 ID 发起 Transfer 打款。
请求
merchantNoOnerway 分配的商户号。通常在沙盒或生产商户开通后，从商户后台或开户材料中获取。
示例：
801129payerId条件：需在
本次打款使用的已保存付款方 ID。若付款方已预先创建且无需随单内联传递，优先使用该字段。payerId 和 payerDetail 之间二选一。payerDetail{ createTime, merchantNo, ... }条件：需在
以 JSON 字符串编码的付款方详情。适用于未预创建付款方，或需要按本次请求携带最新付款方信息的场景。payerDetail 和 payerId 之间二选一。beneficiaryId本次打款使用的已审核通过收款方 ID。
示例：
1953727182141784064sourceAmount条件：当
扣费前的源金额。按扣款侧金额驱动打款计算时使用该字段。chargeFlag=N 时必填。示例：
113sourceCurrency本次打款的源币种。
示例：
USDtargetAmount条件：当
收款方币种下的预计到账金额。按收款侧到账金额驱动打款计算时使用该字段。chargeFlag=Y 时必填。示例：
1901targetCurrency收款方或目标币种。
示例：
PKRrequestId商户请求流水号；每笔打款请求应保持唯一，用于对账和幂等追踪。
示例：
DM2025081120520reference打款附言或备注；在支持的渠道中，可用于下游对账或收款方账单展示。
transactionPurpose交易用途代码。应与实际业务用途和合规申报要求保持一致。
chargeFlag全额到账标识，用于决定按目标金额还是按源金额驱动计算。
feeBearing条件：SWIFT 打款且需要声明手续费承担方式时必填。
SWIFT 手续费承担方式。sign请求签名字符串，需使用商户私钥按 Transfer 请求签名规则生成。
curl -X POST 'https://sandbox-api.onerway.com/payout/api/v1/txn/remittance' \
-H 'Content-Type: application/json' \
--data-raw '{
"beneficiaryId": "1953727182141784064",
"chargeFlag": "Y",
"merchantNo": "801040",
"payerId": "1953712585351499776",
"reference": "REFERENCE PAYOUT",
"requestId": "DM2025081120520",
"sign": "{{SIGN}}",
"sourceAmount": 113,
"sourceCurrency": "USD",
"targetAmount": 1901,
"targetCurrency": "PKR",
"transactionPurpose": "4"
}'响应
respCodeOnerway 返回的响应码。
respMsgOnerway 返回的响应信息。
data{ merchantNo, payoutId, ... }已创建的打款记录。
{
"respCode": "20000",
"respMsg": null,
"data": {
"merchantNo": "801129",
"payoutId": "1984136974445449216",
"status": "A",
"requestId": "CYPW20251031055450"
}
}该接口暂未记录错误响应。