Onerway
POST

查询支付记录

查看 Markdown
该接口用于按支付意图维度检索交易结果，支持查询同一个 paymentId 下的多笔 transactionId 并用于对账。

请求

merchantNostring必填
Onerway 分配的商户号；获取方式参见接入准备。
示例：replace_with_merchant_no
merchantTxnIdsstring条件必填
条件：作为查询条件之一提供；merchantTxnIds / transactionIds / startTime + endTime / paymentId 至少提供一类。
按商户交易号批量查询 Payment 记录，多个值以逗号分隔。
示例：TXN-2024-001,TXN-2024-002
约束
范围
10个 ID单次请求最多传入 10 个以逗号分隔的 ID。
transactionIdsstring条件必填
条件：作为查询条件之一提供；merchantTxnIds / transactionIds / startTime + endTime / paymentId 至少提供一类。
按 Onerway 交易号批量查询 Payment 记录，多个值以逗号分隔。
示例：1787743316310622208,1787743316310622209
约束
范围
10个 ID单次请求最多传入 10 个以逗号分隔的 ID。
paymentIdstring条件必填
条件：作为查询条件之一提供；merchantTxnIds / transactionIds / startTime + endTime / paymentId 至少提供一类。
支付意图 ID，JSON 中以 String 传输。用于按 Payment 维度检索关联交易与退款记录。
示例：2031908578000000000
txnTypesstring可选
按 Payment 下关联交易类型过滤，多个值以逗号分隔；本接口支持 SALE 和 REFUND。
示例：SALE,REFUND
可选值
SALE
支付。
REFUND
退款。
约束
取值
本接口仅支持通用 TxnTypeEnum 中的 SALE / REFUND 子集。
startTimestring条件必填
条件：按时间范围查询时需与 endTime 成对提供；merchantTxnIds / transactionIds / startTime + endTime / paymentId 至少提供一类。
查询时间范围起点，格式 yyyy-MM-dd HH:mm:ss。
示例：2024-02-28 15:05:34
约束
规则
startTime 与 endTime 的区间最大 90 天。
endTimestring条件必填
条件：按时间范围查询时需与 startTime 成对提供。
查询时间范围终点，格式 yyyy-MM-dd HH:mm:ss。
示例：2024-02-28 15:05:34
约束
一致性
endTime 必须晚于 startTime。
规则
startTime 与 endTime 的区间最大 90 天。
currentstring必填
支付记录查询页码。0 和 1 都表示第一页；响应中的 current 统一返回 1-based 页码。
示例：1
sizestring可选
分页大小；单次分页查询最多返回 10 条。
示例：10
signstring必填
请求签名字符串；生成方式详见请求签名。

请求示例

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

响应

respCodestring
响应码；20000 表示查询请求处理成功（指请求受理成功，非单笔交易结果），其余为错误码。完整码表见响应码。
respMsgstring
响应码对应的可读说明。
业务数据对象，包含 Payment 记录列表与分页信息。

响应示例

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "content": [
      {
        "paymentId": "replace_with_payment_id",
        "paymentStatus": "S",
        "lastTransactionId": "replace_with_transaction_id",
        "lastPaymentAttempt": null,
        "merchantTxnId": "example_merchant_transaction_id",
        "merchantTxnOriginalId": null,
        "txnTime": "2026-01-15 10:30:00",
        "txnCompletionTime": "2026-01-15 10:30:30",
        "productType": "CARD",
        "subProductType": "DIRECT",
        "cardType": "AE",
        "orderAmount": "100.00",
        "orderCurrency": "USD",
        "txnAmount": "100.00",
        "txnCurrency": "USD",
        "arn": null,
        "appId": "replace_with_app_id",
        "website": "https://merchant.example.com",
        "cardNumber": "370000******0002",
        "holderName": "Example Cardholder",
        "eci": null,
        "email": "customer@example.com",
        "channelRequestId": "replace_with_channel_request_id",
        "paymentMethodDetails": {
          "card": {
            "checks": {
              "addressCheck": "fail",
              "postalCodeCheck": "fail",
              "cardholderNameCheck": "fail",
              "avsResultRawCode": "W",
              "threeDSecureResult": null
            },
            "holderName": "Example Cardholder",
            "year": "2029",
            "month": "11",
            "cardType": "AE",
            "productCategory": null,
            "issuer": "Example American Express Issuer",
            "cardBinCountry": "US",
            "authorizationCode": "replace_with_authorization_code",
            "cardNumber": "370000******0002"
          }
        }
      }
    ],
    "current": "1",
    "size": 10,
    "totalPages": 1,
    "totalElements": 1
  }
}
该接口暂未记录错误响应。

查询可用支付方式

查询当前订单上下文可用的支付方式。

查询退款记录

按支付意图、退款交易、原交易或时间范围查询退款记录。