POST
查询交易记录
该接口用于按交易流水维度检索交易记录，支持对账、争议处理与报表核对。
请求
merchantTxnIds条件：作为查询条件之一提供；
按商户交易号批量查询，多个值以逗号分隔。merchantTxnIds / transactionIds / startTime + endTime 至少提供一类。示例：
txn_demo_202606210001,txn_demo_202606210002约束
- 范围
10个 ID单次请求最多传入 10 个以逗号分隔的 ID。
transactionIds条件：作为查询条件之一提供；
按 Onerway 交易号批量查询，多个值以逗号分隔。merchantTxnIds / transactionIds / startTime + endTime 至少提供一类。示例：
2031908578000000000,2031908578000000001约束
- 范围
10个 ID单次请求最多传入 10 个以逗号分隔的 ID。
startTime条件：按时间范围查询时需与
查询时间范围的起点，按交易创建时间过滤，格式 endTime 成对使用；merchantTxnIds / transactionIds / startTime + endTime 至少提供一类。yyyy-MM-dd HH:mm:ss。示例：
2026-06-01 00:00:00约束
- 规则
startTime与endTime的区间最大 90 天。
endTime条件：按时间范围查询时需与
查询时间范围的终点，格式 startTime 成对使用。yyyy-MM-dd HH:mm:ss。示例：
2026-06-21 23:59:59约束
- 一致性
endTime必须晚于startTime。- 规则
startTime与endTime的区间最大 90 天。
txnTypes按交易类型过滤查询结果，多个值以逗号分隔；省略时返回所有交易类型。
示例：
SALE,AUTH,REFUND可选值
SALE- 支付。
AUTH- 预授权。
REFUND- 退款。
current查询页码。
0 和 1 都表示第一页；响应中的 current 统一返回 1-based 页码。示例：
1size分页大小，当前固定为每页
10 条，暂不支持自定义。示例：
10sign请求签名字符串；生成方式详见请求签名。
curl -X POST 'https://sandbox-acq.onerway.com/v1/txn/list' \
-H 'Content-Type: application/json' \
--data-raw '{
"merchantNo": "replace_with_merchant_no",
"transactionIds": "replace_with_transaction_id",
"current": "0",
"sign": "{{SIGN}}"
}'响应
respCode响应码；
20000 表示查询请求处理成功，不代表单笔交易结果；其余为错误码。完整码表见响应码。respMsg响应码对应的可读说明。
data{ content, current, ... }业务数据对象，包含分页交易记录列表与分页信息。
{
"respCode": "20000",
"respMsg": "Success",
"data": {
"content": [
{
"transactionId": "replace_with_transaction_id",
"paymentId": "replace_with_payment_id",
"merchantTxnId": "example_merchant_transaction_id",
"merchantTxnOriginalId": null,
"txnTime": "2026-01-15 10:30:00",
"txnTimeZone": "+08:00",
"txnCompletionTime": "2026-01-15 10:30:30",
"originTransactionId": null,
"productType": "CARD",
"subProductType": "DIRECT",
"txnType": "SALE",
"status": "S",
"contractId": null,
"tokenId": null,
"userPaymentStatus": null,
"cardType": "AE",
"paymentMethod": "AE",
"orderAmount": "100.00",
"settleRate": "1",
"orderCurrency": "USD",
"txnAmount": "100.00",
"txnCurrency": "USD",
"customsDeclarationAmount": null,
"customsDeclarationCurrency": null,
"arn": null,
"appId": "replace_with_app_id",
"website": "https://merchant.example.com",
"cardBinCountry": "US",
"cardNumber": "370000******0002",
"walletTypeName": null,
"reason": null,
"holderName": "Example Cardholder",
"eci": null,
"email": "customer@example.com",
"creditCard": {
"holderName": "Example Cardholder",
"year": "2029",
"month": "11",
"verificationResult": null,
"cardType": "AE",
"productCategory": null,
"issuer": "Example American Express Issuer",
"cardNumber": "370000******0002"
},
"channelRequestId": "replace_with_channel_request_id",
"lpmsUserId": null,
"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"
}
},
"metaData": null
}
],
"current": "1",
"size": 10,
"totalPages": 1,
"totalElements": 1
}
}该接口暂未记录错误响应。