---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/tokenization/cof/bindList/index.md
description: >-
  The card binding query API provides retrieval services for bound bank card
  information. It is suitable for application scenarios that need to obtain
  details of user-bound payment methods, supporting queries for all valid cards
  under a customer ID. The returned data includes but is not limited to card
  aliases, types, and partially masked card numbers, facilitating further
  processing or display to users.
---
# Card Binding Query API

```apidef
endpoint: POST /v4/paymethod/bind/list
name: Card Binding Query API
summary: Query bound international cards
variant: International Card
tags: Tokenization, CardOnFile
```

The card binding query API provides retrieval services for bound bank card information. It is suitable for application scenarios that need to obtain details of user-bound payment methods, supporting queries for all valid cards under a customer ID. The returned data includes but is not limited to card aliases, types, and partially masked card numbers, facilitating further processing or display to users.

## Request Parameters

| Parameter | Type | Required | Description |
|--------|------|------|------|
| accId | string | M | Unique identifier for the store, which will appear in the response message after creation; inputting it means modifying the data |
| clientId | string | M | PingPong Merchant ID |
| signType | string | M | Supports MD5 , SHA256; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document |
| sign | string | M | Signature; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document. All parameters participate in the signature |
| version | string | M | Version number, currently fixed at 1.0, may be adjusted with changes to the interface in the future |
| bizContent | string | M | Collection of request parameters, with no limit on maximum length. Except for common request parameters, all other request parameters must be passed within this parameter, format: JSON string |
| └─ requestId | string | M | Unique Request Number |
| └─ merchantUserId | string | M | Member ID, the user's member ID on the merchant website |
| └─ token | string | O | Authorization Token |

### Request Example

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

## Response Parameters

| Parameter | Type | Description |
|--------|------|------|
| sign | string | Signature Value |
| bizContent | string | Business Content |
| └─ bindInfos | object | Binding Information |
| └─ └─ bizType | string | CardOnFile |
| └─ └─ cardExpireYear | string | Expiration Year, 4 digits |
| └─ └─ desensitizedCardNo | string | Card Number (first six and last four digits) |
| └─ └─ payMethod | string | Payment Method |
| └─ └─ clientId | string | PingPong Merchant ID |
| └─ └─ token | string | The token value of the stored-card record. For server-side token payment, pass it under the `token` field in the `uniformly` request. In checkout CVV repeat-purchase scenarios, if multiple cards are bound under the same user and only one card should be displayed, pass this value under the `cardToken` field in the `prePay` request |
| └─ └─ accId | string | Unique Store Identifier |
| └─ └─ merchantUserId | string | Member ID, the user's member ID on the merchant's website |
| └─ └─ cardExpireMonth | string | Expiration Month, 2 digits |
| └─ └─ status | string | Status ACTIVE; INVALID |
| signType | string | Signature Method |
| code | string | Result Status Code |
| description | string | Result Description |

### Response Example

```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"
}
```