• 简体中文
  • Token 查询(卡支付)

    适用市场:ZA 南非

    /api/v1/card/token/query

    通过 cardToken 查询已绑定卡片的详细信息,包括卡品牌、卡号后四位等。

    前置条件:需先通过 独立绑卡 或 创建订单 rememberCard=true 获取 cardToken。

    请求参数

    参数类型必填说明
    cardTokenstring是卡 Token
    nonceStrstring是随机字符串(参与签名)
    requestTimestring是Unix 毫秒时间戳
    versionstring是2.0.0.0

    返回值

    字段类型说明
    cardTokenstring卡 Token(回显)
    tokenStatusstringtoken状态,详见卡Token状态
    cardBrandstring卡品牌
    cardTypestring卡类型
    bankNamestring发卡行
    cardNostring完整卡号
    cardLast4string卡号后四位
    ecistring3DS ECI 值
    cardCountrystring发卡国家,返回规则同 cardBrand
    createTimestring绑卡时间(ISO 8601)
    updateTimestring最近更新时间(ISO 8601)

    示例

    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",
        "cardLast4": "4370",
        "cardCountry": "ZA",
        "eci": "05",    
        "createTime": "2026-06-24T13:21:21.623+00:00",
        "updateTime": "2026-06-29T11:27:12.872+00:00"
    }
    }