Onerway
POST

List saved tokens

Use this endpoint to list saved tokens under a merchant customer. The response returns the binding record ID for deletion and the tokenId for later token payment or subscription operations.

Request

merchantNo
Merchant number assigned by Onerway when the merchant account is created.
Example:
appId
Merchant application ID. When omitted, Onerway queries saved tokens under the merchant number. When provided, the query is limited to tokens under the specified appId.
Example:
merchantCustId
Unique customer identifier in the merchant system, used to limit the token query to a specific customer.
Example:
subProductType
Token type to query. When omitted, Onerway queries card tokens. Submit SUBSCRIBE to query subscription tokens.
Example:
Allowed values
TOKEN
Saved payment method token query.
SUBSCRIBE
Subscription token query.
sign
Request signature string. See Request signing for how to generate it.

Request example

curl -X POST 'https://sandbox-acq.onerway.com/v1/txn/queryTokenList' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "merchantCustId": "cust_demo_token_202606150001",
  "merchantNo": "replace_with_merchant_no",
  "sign": "{{SIGN}}",
  "subProductType": "TOKEN"
}'

Response

respCode
20000 means the query request was processed successfully. It does not guarantee that token details are returned. Other values are error codes. See Response codes.
respMsg
Human-readable message for the response code.
Business data object carrying the merchant number and token details.

Response example

Example code is unavailable.

No error responses are documented for this endpoint.