Onerway
POST

查询退款记录

查询退款记录,并通过 paymentId 关联对应的支付意图。未收到退款通知时,可调用本接口查询结果;通知见退款结果通知与退款审核拒绝通知。

请求

merchantNo
Onerway 分配的商户号;获取方式参见接入准备。
示例:
paymentId
条件:作为查询条件之一提供;paymentId / transactionId / originTransactionId / startTime + endTime 至少提供一类。
支付意图 ID,JSON 以 String 传输,可按 Payment 维度检索关联交易与退款记录。
示例:
transactionId
条件:作为查询条件之一提供;paymentId / transactionId / originTransactionId / startTime + endTime 至少提供一类。
退款交易流水号,JSON 以 String 传输,可按单次退款交易精确查询退款记录。
示例:
originTransactionId
条件:作为查询条件之一提供;paymentId / transactionId / originTransactionId / startTime + endTime 至少提供一类。
退款关联的原始 Onerway 交易 ID,JSON 以 String 传输,用于按原交易维度关联退款记录。
示例:
startTime
条件:按时间范围查询时需与 endTime 成对提供;paymentId / transactionId / originTransactionId / startTime + endTime 至少提供一类。
查询时间范围的起点,按交易创建时间过滤,格式 yyyy-MM-dd HH:mm:ss。
示例:
约束
规则
startTime 与 endTime 的区间最大 90 天。
endTime
条件:按时间范围查询时需与 startTime 成对提供。
查询时间范围的终点,格式 yyyy-MM-dd HH:mm:ss。
示例:
约束
一致性
endTime 必须晚于 startTime。
规则
startTime 与 endTime 的区间最大 90 天。
current
退款记录查询页码。0 和 1 都表示第一页;不传默认第一页;响应中的 current 统一返回 1-based 页码。
示例:
size
分页大小;本接口每页最多返回 10 条,暂不支持自定义分页大小。
示例:
sign
请求签名字符串;生成方式详见请求签名。

请求示例

curl -X POST 'https://sandbox-acq.onerway.com/v1/txn/queryRefunds' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "current": "1",
  "merchantNo": "replace_with_merchant_no",
  "paymentId": "2031908578000000000",
  "sign": "{{SIGN}}",
  "size": "10"
}'

响应

respCode
响应码;20000 表示查询请求处理成功,不代表单条退款最终成功;其余为错误码。完整码表见响应码。
respMsg
响应码对应的可读消息。
业务数据对象,包含退款记录列表与分页信息。

响应示例

示例代码暂不可用。

该接口暂未记录错误响应。