Onerway
POST

Query transaction records

View as Markdown
Use this endpoint to query card transaction records by transaction type, status, card ID, and time range.

Request

ApiKeystringrequired
Issuing API key request header assigned by Onerway.
Example:replace_with_issuing_api_key
txnTypestringoptional
Transaction type filter.
Allowed values
AUTHORIZATION
Authorization transaction.
REVERSAL
Reversal transaction.
CLEARING
Clearing transaction.
txnStatusstringoptional
Transaction status filter.
Allowed values
S
Succeeded.
F
Failed.
P
Processing.
cardIdstringoptional
Card ID filter.
Example:100001
startTimeintegeroptional
Query start time, as a UTC timestamp in seconds.
Example:1735689600
endTimeintegeroptional
Query end time, as a UTC timestamp in seconds.
Example:1735776000
pageNumintegerrequireddefault1
Page number.
Example:1
Constraints
Range
1
pageSizeintegerrequireddefault10
Page size.
Example:10
Constraints
Range
1100

Request example

curl -X POST 'https://sandbox-api.onerway.com/api/v1/merchant/queryTxnList' \
  -H 'ApiKey: replace_with_issuing_api_key' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "cardId": "100001",
  "pageNum": 1,
  "pageSize": 10,
  "txnType": "AUTHORIZATION"
}'

Response

respCodestring
Business response code. 20000 means success.
respMsgstring
Response message.
Paginated transaction records.

Response example

{
  "respCode": "20000",
  "respMsg": "success",
  "data": {
    "totalRecords": 1,
    "pageSize": 10,
    "current": 1,
    "pageNum": 1,
    "totalPages": 1,
    "records": [
      {
        "txnType": "AUTHORIZATION",
        "txnStatus": "S",
        "txnOrderNo": "TXN20260101001",
        "originTxnOrderNo": null,
        "originTxnOrderNoForRefund": null,
        "cardId": "100001",
        "authTime": 1735689600000,
        "authorizationCode": "AUTH001",
        "authMessageDesc": "Approved",
        "transactionAmount": 50,
        "transactionCurrency": "USD",
        "transactionTime": 1735689600000,
        "cardAmount": 50,
        "cardCurrency": "USD",
        "settleAmount": 50,
        "settleCurrency": "USD",
        "settleTime": 1735776000000,
        "transactionFee": 0.5,
        "transactionFeeCurrency": "USD",
        "crossBorderFee": null,
        "crossBorderFeeCurrency": null,
        "exchangeFee": null,
        "exchangeFeeCurrency": null,
        "merchantId": "example_merchant_id",
        "merchantName": "Example Merchant",
        "merchantCountry": "United States",
        "merchantCountryCode": "US",
        "merchantStateProvince": "WA",
        "merchantCity": "Seattle",
        "merchantPostalCode": "98101",
        "merchantMccCode": "5411"
      }
    ]
  }
}
No error responses are documented for this endpoint.

Mobile area code list

Query supported mobile area codes.

Query 3DS records

Query paginated 3DS delivery records by card, transaction order number, and time range.