Onerway
POST

Query 3DS records

View as Markdown
Use this endpoint to query 3DS delivery records for an issued card.

Request

ApiKeystringrequired
Issuing API key request header assigned by Onerway.
Example:replace_with_issuing_api_key
txnOrderNostringoptional
Transaction order number filter.
Constraints
Rule
Must not exceed 64 characters.
cardIdstringrequired
Card ID filter.
Example:example_card_id
Constraints
Rule
Must not exceed 64 characters.
startTimeintegeroptional
Query start time as a Unix timestamp in seconds.
Example:1767225600
endTimeintegeroptional
Query end time as a Unix timestamp in seconds.
Example:1767312000
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/query3dsNotify' \
  -H 'ApiKey: replace_with_issuing_api_key' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "cardId": "example_card_id",
  "startTime": 1767225600,
  "endTime": 1767312000,
  "pageNum": 1,
  "pageSize": 10
}'

Response

respCodestring
Business response code. 20000 means success.
respMsgstring
Response message.
Paginated 3DS delivery records.

Response example

{
  "respCode": "20000",
  "respMsg": "success",
  "data": {
    "totalRecords": 1,
    "pageSize": 10,
    "current": 1,
    "pageNum": 1,
    "totalPages": 1,
    "records": [
      {
        "txnOrderNo": "example_transaction_order",
        "merchantNo": "example_merchant_no",
        "cardId": "example_card_id",
        "type": "OTP",
        "sendMethod": "WEBHOOK",
        "sendTarget": "https://example.com/webhooks/3ds",
        "sendStatus": "S",
        "sendTime": 1767225600000,
        "card3dsValues": "123456",
        "currency": "USD",
        "amount": 125.50,
        "merchantName": "Example Merchant"
      }
    ]
  }
}
No error responses are documented for this endpoint.

Query transaction records

Query card transaction records with pagination and optional filters.

List card products

Retrieve the card products and related configuration available to the merchant.