Skip to main content
POST
/
api
/
v1
/
tokenization
/
inquiry
Tokenization Inquiry
curl --request POST \
  --url http://localhost:8080/cardcenter/api/v1/tokenization/inquiry \
  --header 'Content-Type: application/json' \
  --data '
{
  "merchantInfo": {
    "merchantId": "<string>",
    "subMerchantId": "<string>"
  },
  "tokenRequestId": "<string>",
  "merchantUserId": "<string>",
  "tokenId": "<string>",
  "tokenType": "<string>"
}
'
{
  "code": "<string>",
  "msg": "<string>",
  "msgParams": {},
  "data": [
    {
      "tokenRequestId": "<string>",
      "tokenId": "<string>",
      "tokenType": "<string>",
      "tokenStatus": "<string>",
      "merchantUserId": "<string>",
      "tokenData": {
        "maskedCardInfo": "<string>",
        "cardHolderName": "<string>",
        "cardExpiry": "<string>",
        "cardBin": "<string>",
        "cardScheme": "<string>",
        "cardType": "<string>",
        "cardIssuerName": "<string>",
        "cardIssueCountryCode": "<string>"
      },
      "billingAddress": {
        "countryCode": "<string>",
        "region": "<string>",
        "city": "<string>",
        "postalCode": "<string>",
        "address": "<string>"
      },
      "merchantInfo": {
        "merchantId": "<string>",
        "subMerchantId": "<string>"
      }
    }
  ],
  "success": true,
  "fail": true
}

Documentation Index

Fetch the complete documentation index at: https://waffo.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
merchantInfo
object
required

Merchant info.

tokenRequestId
string

Tokenization request ID sent from Merchant. It will also be used for idempotent check.

Maximum string length: 64
merchantUserId
string

The merchant's userId must be unique for each user of merchants. Either merchantUserId or tokenId must be provided to look up bound cards.

Maximum string length: 64
tokenId
string

The tokenization id of card info. The merchant needs to securely store this field, and subsequently, when initiating user payments or backend deductions, this token can be used to replace the user's card information for payment.

Maximum string length: 64
tokenType
string

Types of requested tokenization: CARD. Required unless tokenId is provided.

Maximum string length: 32

Response

200 - */*

OK

Standard API response envelope.

code
string

Result code. "0" indicates success; any other value indicates failure.

msg
string

Human-readable message corresponding to the result code.

msgParams
object

Key-value parameters associated with the error message, used for templated errors.

data
object[]

Response payload. Empty when the request fails.

success
boolean
fail
boolean