• English
  • Token Query (Card Payment)

    Applicable market: ZA South Africa

    /api/v1/card/token/query

    Query detailed card information via cardToken, including card brand, last 4 digits, and more.

    Prerequisite: A cardToken must first be obtained through [standalone card binding] or by creating an order with rememberCard=true.

    Request Parameters

    ParameterTypeRequiredDescription
    cardTokenstringYesCard token
    nonceStrstringYesRandom string (included in signature)
    requestTimeintegerYesUnix timestamp in milliseconds
    versionstringYes2.0.0.0

    Response Fields

    FieldTypeDescription
    cardTokenstringCard token (echoed back)
    tokenStatusstringToken status, see Card Token Status for details
    cardBrandstringCard Scheme
    cardTypestringCard type: debit_card & credit_card
    bankNamestringissuing bank
    cardNostringFull card number
    cardLast4stringLast 4 digits of the card number
    cardCountrystringIssuing country. Same return rules as cardBrand.
    ecistring3DS ECI result
    createTimestringCard binding time (ISO 8601)
    updateTimestringLast update time (ISO 8601)

    Example

    curl 'https://open-gw-daily.palmpay-inc.com/api/v1/card/token/query' \
      -H 'CountryCode: ZA' -H 'Authorization: Bearer xxx' -H 'Content-Type: application/json' \
      -d '{"cardToken":"60871b47d2e7444b859848c567824bfd",
           "nonceStr":"Uppkllengkknwwnkklr","requestTime":16999258500,"version":"2.0.0.0"}'
    {
      "respCode": "00000000",
      "respMsg": "success",
      "status": true,
      "data": {
        "cardToken": "b340318fcd70402eb56d87f72718d5d4",
        "tokenStatus": "4",
        "cardBrand": "VISA",
        "cardNo": "4007383752744370",
        "cardType": "debit_card",
        "bankName": "FIRST NATIONAL BANK",
        "cardCountry": "ZA",
        "cardLast4": "4370",
        "eci": "05",    
        "createTime": "2026-06-24T13:21:21.623+00:00",
        "updateTime": "2026-06-29T11:27:12.872+00:00"
    }
    }