Onerway
POST

Query card operation records

View as Markdown
Use this endpoint to query card operation records by card ID, idempotent request ID, operation type, and time range.

Request

ApiKeystringrequired
Issuing API key request header assigned by Onerway.
Example:replace_with_issuing_api_key
cardIdintegeroptional
Card ID filter. If omitted, records for all merchant cards can be queried.
Example:100001
clientRequestIdstringoptional
Idempotent request ID filter.
Example:REQ_20260101_001
typestringoptional
Operation type filter.
Allowed values
CREATE
Card creation operation.
FREEZE
Card freeze operation.
UNFREEZE
Card unfreeze operation.
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/card/getOperateRecordList' \
  -H 'ApiKey: replace_with_issuing_api_key' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "cardId": 100001,
  "pageNum": 1,
  "pageSize": 10,
  "type": "DEPOSIT"
}'

Response

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

Response example

{
  "respCode": "20000",
  "respMsg": "success",
  "data": {
    "totalRecords": 1,
    "pageSize": 10,
    "current": 1,
    "pageNum": 1,
    "totalPages": 1,
    "records": [
      {
        "operateRecordId": 200001,
        "cardId": 100001,
        "clientRequestId": "REQ_20260101_001",
        "type": "DEPOSIT",
        "status": "S",
        "remark": null,
        "amount": 100,
        "currency": "USD",
        "operateTime": 1735689600000,
        "feeList": [
          {
            "feeType": "DEPOSIT",
            "feeAmount": 1,
            "feeCurrency": "USD"
          }
        ]
      }
    ]
  }
}
No error responses are documented for this endpoint.

Withdraw card balance

Withdraw a card's available balance to the Onerway account.

Get card basic info

Query basic status information for a card.