#Token 查询(卡支付)
适用市场:ZA 南非
/api/v1/card/token/query通过 cardToken 查询已绑定卡片的详细信息,包括卡品牌、卡号后四位等。
前置条件:需先通过 独立绑卡 或 创建订单
rememberCard=true获取cardToken。
#请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cardToken | string | 是 | 卡 Token |
| nonceStr | string | 是 | 随机字符串(参与签名) |
| requestTime | string | 是 | Unix 毫秒时间戳 |
| version | string | 是 | 2.0.0.0 |
#返回值
| 字段 | 类型 | 说明 |
|---|---|---|
| cardToken | string | 卡 Token(回显) |
| tokenStatus | string | token状态,详见卡Token状态 |
| cardBrand | string | 卡品牌 |
| cardType | string | 卡类型 |
| bankName | string | 发卡行 |
| cardNo | string | 完整卡号 |
| cardLast4 | string | 卡号后四位 |
| eci | string | 3DS ECI 值 |
| cardCountry | string | 发卡国家,返回规则同 cardBrand |
| createTime | string | 绑卡时间(ISO 8601) |
| updateTime | string | 最近更新时间(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"
}
}