---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/tokenization/cof/unbind/index.md
description: >-
  解绑接口用于取消已绑定的支付卡与用户账户之间的关联。适用于需要移除或更新支付方式的场景，支持全球范围内的支付卡操作。通过调用此API，开发者可以实现安全、高效地管理用户的支付卡信息，关键参数包括用户标识符和待解绑卡片的token。
---
# 解绑接口

```apidef
endpoint: POST /v4/paymethod/unbind
name: 解绑接口
summary: 解除国际信用卡绑定
variant: 国际信用卡
tags: Tokenization, CardOnFile
```

解绑接口用于取消已绑定的支付卡与用户账户之间的关联。适用于需要移除或更新支付方式的场景，支持全球范围内的支付卡操作。通过调用此API，开发者可以实现安全、高效地管理用户的支付卡信息，关键参数包括用户标识符和待解绑卡片的token。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| 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。 |
| └─ merchantUserId | string | M | 会员ID，用户在商户网站的会员ID |
| └─ requestId | string | M | 唯一请求号 |
| └─ notificationUrl | string | M | 商户通知地址。
地址建议：请填写基于公网域名的完整 URL，推荐使用标准 Web 端口（HTTPS 默认 443，HTTP 默认 80），并确保该地址可稳定接收 PingPongCheckout 的异步通知。 |
| └─ token | string | M | 授权token |

### 请求示例

```json
{
  "accId": "2022102018024210348883",
  "bizContent": "{\"merchantUserId\":\"12604896432523150\",\"requestId\":\"PMT-FTP2Z512691717055099734\",\"notificationUrl\":\"https://test-acquirerpay.pingpongx.com/qa/result.html\",\"token\":\"97b4e5b9fb4e53727ef7cbf0b25a3d42\"}",
  "clientId": "2022102018024210348",
  "sign": "CC99F6BCE0DB36D8F05C7BD95FCF21C11392490D8BA62D5E290F742D520262BD",
  "signType": "SHA256",
  "version": "1.0"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| code | string | 结果状态码，见附录状态码表: /notes/zh/appendix/successCodeList/ |
| description | string | 结果描述 |
| sign | string | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| signType | string | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| bizContent | string | 业务响应参数。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ token | string | 授权token |
| └─ merchantUserId | string | 用户id |
| └─ status | string | 状态，INVALID |

### 响应示例

```json
{
  "bizContent": "{\"token\":\"97b4e5b9fb4e53727ef7cbf0b25a3d42\",\"merchantUserId\":\"12604896432523150\",\"status\":\"INVALID\"}",
  "code": "001000",
  "description": "Successful request",
  "sign": "394A51CD4D9DCEA3266988AAEBDDE113074A88D5B0BC964B8F45E474E0C1E694",
  "signType": "SHA256"
}
```