POST
查询分账结果
该接口用于查询一笔分账或分账回退的处理结果,查看整体状态,并逐条确认各接收方明细的处理结果。
请求
gatewayReference条件:
profitReference、gatewayReference、profitGatewayReference、relatedTxnId、relatedMerchantTxnId 至少提供一个。share 时为原 SALE 支付的 transactionId;return 时为被回退的 Onerway 分账单号。按原支付交易查询分账回退时,使用 relatedTxnId。示例:
replace_with_transaction_idmerchantNo发起本次查询的商户号。
示例:
replace_with_merchant_no约束
- 规则
- 接受字符串或 JSON 数字。建议使用字符串,避免数值精度损失并保留完整标识。
- 规则
- 平台模式下,传入原支付的收款子商户号。通过 API 发起分账时,应与该分账请求中的
merchantNo一致。
profitGatewayReference条件:
发起分账或分账回退时 Onerway 返回的单号。profitReference、gatewayReference、profitGatewayReference、relatedTxnId、relatedMerchantTxnId 至少提供一个。示例:
replace_with_profit_gateway_referenceprofitReference条件:
分账或分账回退请求号。通过 API 发起时,使用商户在发起请求中提供的请求号;自动分账或自动分账回退时,由 Onerway 生成。profitReference、gatewayReference、profitGatewayReference、relatedTxnId、relatedMerchantTxnId 至少提供一个。示例:
example_profit_share_referencerelatedTxnId条件:
原支付交易流水号;分账与分账回退均关联原支付交易。profitReference、gatewayReference、profitGatewayReference、relatedTxnId、relatedMerchantTxnId 至少提供一个。约束
- 规则
- 接受字符串或 JSON 数字。建议使用字符串,避免数值精度损失并保留完整标识。
- 一致性
- 同时提供多个查询标识时,按这些条件组合过滤。
relatedMerchantTxnId条件:
原支付的商户订单号;分账与分账回退均关联原支付订单。profitReference、gatewayReference、profitGatewayReference、relatedTxnId、relatedMerchantTxnId 至少提供一个。约束
- 一致性
- 同时提供多个查询标识时,按这些条件组合过滤。
profitType要查询的单据类型:分账或分账回退。
示例:
share可选值
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响应码对应的可读说明。
data{ profitType, profitReference, ... }分账或分账回退结果。
{
"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\"}]"
}
}该接口暂未记录错误响应。