---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/tokenization/cof/bindList/index.md
description: >-
  绑卡查询接口提供已绑定银行卡信息的检索服务。适用于需要获取用户已绑定支付方式详情的应用场景，支持通过客户ID查询其名下所有有效卡片列表。返回数据包括但不限于卡片别名、类型及部分脱敏卡号等关键信息，便于进一步处理或展示给用户。
---
# 绑卡查询接口

```apidef
endpoint: POST /v4/paymethod/bind/list
name: 绑卡查询接口
summary: 查询国际信用卡绑卡列表
variant: 国际信用卡
tags: Tokenization, CardOnFile
```

绑卡查询接口提供已绑定银行卡信息的检索服务。适用于需要获取用户已绑定支付方式详情的应用场景，支持通过客户ID查询其名下所有有效卡片列表。返回数据包括但不限于卡片别名、类型及部分脱敏卡号等关键信息，便于进一步处理或展示给用户。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | 店铺唯一标识 |
| clientId | string | M | PingPong 商户号 |
| signType | string | M | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | M | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| version | string | M | 版本号，当前固定为1.0，后续随接口变动可能有调整 |
| bizContent | string | M | 请求参数的集合，最大长度不限，除公共请求参数外所有请求参数都必须放在这个参数中传递，格式：JSON字符串。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ requestId | string | M | 唯一请求号 |
| └─ merchantUserId | string | M | 会员ID，用户在商户网站的会员ID |
| └─ token | string | O | 授权token |

### 请求示例

```json
{
  "accId": "2022102018024210348883",
  "bizContent": "{\"merchantUserId\":\"12604896432523150\",\"requestId\":\"PMT-0206YVVW1N1717039944643\",\"token\":\"97b4e5b9fb4e53727ef7cbf0b25a3d42\"}",
  "clientId": "2022102018024210348",
  "sign": "C588E6B7F9AD3507CEA2D100DF1C8A2D4180B2B4FFC7540E10216F48CAE6C1E2",
  "signType": "SHA256",
  "version": "1.0"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| sign | string | 签名值 |
| bizContent | string | 业务内容。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ bindInfos | object | 绑定信息 |
| └─ └─ bizType | string | CardOnFile |
| └─ └─ cardExpireYear | string | 有效期-年，4位数字 |
| └─ └─ desensitizedCardNo | string | 卡号（前六后四） |
| └─ └─ payMethod | string | 支付方式 |
| └─ └─ clientId | string | PingPong 商户号 |
| └─ └─ token | string | 已保存卡记录的 token 值。服务端 token 支付时在 `uniformly` 请求中通过 `token` 字段传入；收银台 CVV 复购场景下，如同一用户绑定了多张卡且需仅展示其中一张，可在 `prePay` 请求中通过 `cardToken` 字段传入该值 |
| └─ └─ accId | string | 店铺唯一标识 |
| └─ └─ merchantUserId | string | 会员ID，用户在商户网站的会员ID |
| └─ └─ cardExpireMonth | string | 有效期-月，2位数字 |
| └─ └─ status | string | 状态 ACTIVE; INVALID |
| signType | string | 签名方式 |
| code | string | 结果状态码 |
| description | string | 结果描述 |

### 响应示例

```json
{
  "bizContent": "{\"bindInfos\":[{\"bizType\":\"CardOnFile\",\"cardExpireYear\":\"2025\",\"desensitizedCardNo\":\"529991*********0015\",\"payMethod\":\"Mastercard\",\"clientId\":\"2022102018024210348\",\"token\":\"97b4e5b9fb4e53727ef7cbf0b25a3d42\",\"accId\":\"2022102018024210348883\",\"merchantUserId\":\"12604896432523150\",\"cardExpireMonth\":\"12\",\"status\":\"ACTIVE\"}]}",
  "code": "001000",
  "description": "Successful request",
  "sign": "49088AFE5749B7E785F220529963C4E5E719F08F938E45E68C41CE85F56CADCF",
  "signType": "SHA256"
}
```