Onerway
POST

查询分账结果

该接口用于查询一笔分账或分账回退的处理结果,查看整体状态,并逐条确认各接收方明细的处理结果。

请求

gatewayReference
条件:profitReference、gatewayReference、profitGatewayReference、relatedTxnId、relatedMerchantTxnId 至少提供一个。
share 时为原 SALE 支付的 transactionId;return 时为被回退的 Onerway 分账单号。按原支付交易查询分账回退时,使用 relatedTxnId。
示例:
merchantNo
发起本次查询的商户号。
示例:
约束
规则
接受字符串或 JSON 数字。建议使用字符串,避免数值精度损失并保留完整标识。
规则
平台模式下,传入原支付的收款子商户号。通过 API 发起分账时,应与该分账请求中的 merchantNo 一致。
profitGatewayReference
条件:profitReference、gatewayReference、profitGatewayReference、relatedTxnId、relatedMerchantTxnId 至少提供一个。
发起分账或分账回退时 Onerway 返回的单号。
示例:
profitReference
条件:profitReference、gatewayReference、profitGatewayReference、relatedTxnId、relatedMerchantTxnId 至少提供一个。
分账或分账回退请求号。通过 API 发起时,使用商户在发起请求中提供的请求号;自动分账或自动分账回退时,由 Onerway 生成。
示例:
relatedTxnId
条件:profitReference、gatewayReference、profitGatewayReference、relatedTxnId、relatedMerchantTxnId 至少提供一个。
原支付交易流水号;分账与分账回退均关联原支付交易。
约束
规则
接受字符串或 JSON 数字。建议使用字符串,避免数值精度损失并保留完整标识。
一致性
同时提供多个查询标识时,按这些条件组合过滤。
relatedMerchantTxnId
条件:profitReference、gatewayReference、profitGatewayReference、relatedTxnId、relatedMerchantTxnId 至少提供一个。
原支付的商户订单号;分账与分账回退均关联原支付订单。
约束
一致性
同时提供多个查询标识时,按这些条件组合过滤。
profitType
要查询的单据类型:分账或分账回退。
示例:
可选值
share
查询分账结果。
return
查询分账回退结果。
sign
请求签名字符串;生成方式详见请求签名。

请求示例

curl -X POST 'https://sandbox-acq.onerway.com/profit/query' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "gatewayReference": "replace_with_transaction_id",
  "merchantNo": "replace_with_merchant_no",
  "profitGatewayReference": "replace_with_profit_gateway_reference",
  "profitReference": "example_profit_share_reference",
  "profitType": "share",
  "sign": "replace_with_calculated_signature"
}'

响应

respCode
响应码;20000 表示查询处理成功,其余为错误码。完整码表见响应码。
respMsg
响应码对应的可读说明。
分账或分账回退结果。

响应示例

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "profitType": "share",
    "profitReference": "example_profit_share_reference",
    "profitGatewayReference": "replace_with_profit_gateway_reference",
    "state": "completed",
    "currency": "USD",
    "relatedTxnId": "9007199254740993",
    "relatedMerchantTxnId": "example_payment_order",
    "sign": "replace_with_response_signature",
    "receivers": "[{\"profitDetailReference\":\"example_profit_share_detail_reference\",\"profitDetailGatewayReference\":\"replace_with_profit_detail_gateway_reference\",\"type\":\"1\",\"amount\":\"80.00\",\"result\":\"success\",\"failReason\":null,\"createdAt\":\"2026-06-22 10:00:00\",\"finishedAt\":\"2026-06-22 10:00:08\"}]"
  }
}
该接口暂未记录错误响应。