Onerway
POST

打款回调

回调地址
接收打款状态变更后的异步回调,并据此更新您的业务订单状态。

回调报文字段

merchantNo
Onerway 分配的商户号。
requestId
商户请求流水号,用于将本次通知关联到您的业务订单。
payoutId
本次打款对应的 Onerway 打款流水 ID。
约束
规则
该值可能超出 JavaScript 安全整数范围;存储和比对时请按字符串处理。
status
当前打款状态。
可选值
A
待审核。
CA
合规审核中。
B
待检查。
约束
规则
请将该字段作为打款生命周期状态使用;S 表示成功,F 表示最终失败,其余值表示仍在处理中或等待审核。
statusTime
该状态生成时间,格式为 yyyy-MM-dd HH:mm:ss。
payoutStatusReason
当前打款状态的补充原因说明。
settleCurrency
本次打款请求使用的结算币种。
settleSumAmount
本次打款提交的结算金额。
payoutCurrency
收款人到账币种。
payoutAmount
收款人以 payoutCurrency 收到的金额。
serviceFee
本次打款收取的手续费。
convRate
本次打款使用的汇率。

回调示例

{
  "merchantNo": "replace_with_merchant_no",
  "requestId": "replace_with_request_id",
  "payoutId": "replace_with_payout_id",
  "status": "P",
  "statusTime": "2025-01-15 08:32:10",
  "payoutStatusReason": "Submitted to downstream payout channel",
  "settleCurrency": "USD",
  "settleSumAmount": 100,
  "payoutCurrency": "EUR",
  "payoutAmount": 92.35,
  "serviceFee": 2.5,
  "convRate": 0.9235
}

应答说明

成功接收并处理通知后,返回 HTTP 200,并在响应体中返回纯文本 SUCCESS。

应答正文示例

SUCCESS