---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/tokenization/cof/bind/index.md
description: >-
  绑卡获取凭证功能支持用户安全地存储支付信息，适用于需要简化支付流程、提高支付体验的场景。通过将用户的银行卡信息转换为不可逆的令牌，确保敏感数据的安全性。此功能覆盖全球主要市场，支持多种银行卡类型，并提供API接口以方便集成，关键参数包括客户ID、卡片信息等。
---
# 绑卡获取凭证

```apidef
endpoint: POST /v4/paymethod/bind
name: 绑卡获取凭证
summary: 国际信用卡绑卡获取凭证
variant: 国际信用卡
tags: Tokenization, CardOnFile
```

绑卡获取凭证功能支持用户安全地存储支付信息，适用于需要简化支付流程、提高支付体验的场景。通过将用户的银行卡信息转换为不可逆的令牌，确保敏感数据的安全性。此功能覆盖全球主要市场，支持多种银行卡类型，并提供API接口以方便集成，关键参数包括客户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 | C | 会员ID，用户在商户网站的会员ID，适用于快捷支付场景，游客身份的情况可以不传 |
| └─ paymentMethod | object | M | 要使用的付款方式的类型和所需的详细信息。 |
| └─ └─ type | string | M | 付款方式： scheme 国际信用卡支付; 本地支付方式 可选值：Non-Hosted支持的APM: /notes/zh/paymentMethods/overview/; |
| └─ └─ scanCodeId | string | C | 付款代码客户手机钱包客户端生成的支付代码。通常以条形码或QR码的形式显示。商户终端扫描客户的手机屏幕获取代码 |
| └─ └─ cardInfo | object | C | 持卡人信息，信用卡支付，并且不使用绑卡情况必填 |
| └─ └─ └─ number | string | M | 国际信用卡卡号 |
| └─ └─ └─ pin | string | O | 本地卡密码前两位 |
| └─ └─ └─ holderFirstName | string | M | 持卡人名，字符类型，不含特殊符号 |
| └─ └─ └─ holderLastName | string | M | 持卡人姓，字符类型，不含特殊符号 |
| └─ └─ └─ expireMonth | string | M | 有效期-月，2位数字 |
| └─ └─ └─ expireYear | string | M | 有效期-年，4位数字 |
| └─ └─ └─ cvv | string | M | 信用卡CVV，Visa/MasterCard/JCB/Discover/Diners club的cvv字符长度均为三位，American Express的cvv字符长度可能为四位 |
| └─ jsGeneratedData | string | C | 卡支付必须接入风控组件, 卡支付需要传, 若获取失败，可传空字符串，不阻塞支付流程。 通过嵌入pingpong提供的风控组件，获取浏览器相关信息的json字符串，传到这个参数中。使用⻛控插件对接的商户使用，详见3DS集成指南: /notes/zh/risk/3ds/ |
| └─ notificationUrl | string | O | 由商户自定义本次交易结果通知的地址，一旦填写该参数，PingPongCheckout 将通过 POST 方式异步推送交易结果到该地址。
地址建议：请填写基于公网域名的完整 URL，推荐使用标准 Web 端口（HTTPS 默认 443，HTTP 默认 80），并确保该地址可稳定接收 PingPongCheckout 的异步通知。 |
| └─ language | string | O | 用于指定pingpong收银台语言, 不传默认为en。详见附录收银台支持语言列表: /notes/zh/appendix/languageCode/ |
| └─ threeDSRequestData | string | C | 3DS验证请求参数。详见3DS集成指南: /notes/zh/risk/3ds/ |
| └─ └─ executeThreeD | string | C | 3ds验证执行策：
Y-强制进行3ds验证，并且使用PingPongCheckout的3ds; depends-是否进行3ds验证交由PingPongCheckout的风控决策决定; external-需要进行3ds验证，但3ds参数有商户自行收集，交由PingPong执行。备注：此选项不适用于收银台; |
| └─ └─ authenticationValue | string | C | 发卡行在客户身份验证后为Visa、American Express、JCB、Diners Club和Discover交易生成的唯一标识符。原始数据以base64为单位。需要将值转换为格式。 |
| └─ └─ acsTransactionId | string | C | 由ACS分配的唯一事务标识符，用于标识单个事务。 |
| └─ └─ veresEnrolled | string | C | 注册检查的结果。此字段可以包含以下值之一：
Y-卡已注册或可注册；您必须进行身份验证。责任转移。; N-未登记卡；进行授权。责任转移。; U-无论何种原因，都无法进行身份验证。没有责任转移; |
| └─ └─ specificationVersion | string | C | 此字段包含用于处理事务的3D Secure版本。例如，1.0.2或2.0.0。 |
| └─ └─ directoryServerTransactionId | string | C | 目录服务器交易ID由万事达目录服务器在认证交易期间生成，并与认证结果一起传递回商家。 |
| └─ └─ threeDSServerTransactionId | string | C | 3DS服务器分配的唯一事务标识符，用于标识单个事务。 |
| └─ └─ paresStatus | string | C | 身份验证检查的原始结果。此字段可以包含以下值之一：
A-已生成身份验证尝试的证明。; N-客户身份验证失败或取消。交易被拒绝。; U-无论何种原因，身份验证都未完成。; Y-客户已成功通过身份验证。; |
| └─ └─ eci | string | C | 对于验证，仅为Visa、American Express、JCB返回数字电子商务指示符（ECI）Diners Club和Discover交易。身份验证失败时缺少字段。此字段包含以下值之一： 01-尝试身份验证（万事达卡）; 02-认证成功（万事达卡）; 05-Successful authentication (Visa, American Express, JCB, UNION PAY, Diners Club, and Discover); 06-尝试身份验证（Visa、American Express、JCB、Diners Club和Discover）; |

### 请求示例

```json
{
  "accId": "2022102018024210348883",
  "bizContent": "{\"merchantUserId\":\"12604896432523150\",\"requestId\":\"PMT-60KLMY78TS1716979870734\",\"payResultUrl\":\"https://test-acquirerpay.pingpongx.com/qa/result.html\",\"notificationUrl\":\"https://test-acquirerpay.pingpongx.com/qa/result.html\",\"bizType\":\"CardOnFile\",\"paymentMethod\":{\"type\":\"scheme\",\"cardInfo\":{\"cvv\":\"840\",\"number\":\"5299910010000015\",\"expireMonth\":\"12\",\"expireYear\":\"2025\"}},\"threeDSRequestData\":{\"executeThreeD\":\"Y\"},\"browserInfo\":{\"acceptHeader\":\"content-type=application/x-www-form-urlencoded;accept=*/*;cache-control=no-cache;postman-token=cf489264-5378-4d5d-a86c-72c86a408c03;accept-encoding=gzip, deflate;content-length=588;connection=keep-alive;\",\"colorDepth\":\"32\",\"jetLag\":\"480\",\"screenHeight\":\"1980\",\"screenWidth\":\"1080\",\"userAgent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 Chrome/72.0.3626.121 Safari/537.36\",\"windowSize\":\"05\",\"javaEnabled\":\"true\",\"javaScriptEnabled\":\"true\"},\"jsGeneratedData\":{\"fingerprintId\":\"2018092714313010016549_PP20210608151727OB\",\"forterSiteId\":\"e088dda90c4e\",\"forterTokenCookie\":\"c3402ed6f84d4c50add3458a1ce51d60_1623137756842_87_UDF43_11ck\",\"orderTerminal\":\"03\",\"threeDSServerTransID\":\"\"},\"customer\":{\"email\":\"3ds@pingpongx.com\",\"firstName\":\"James\",\"lastName\":\"LeBron\",\"identificationId\":\"\",\"identificationType\":\"ID\",\"phone\":\"3055787343\",\"birthDate\":\"\"},\"device\":{\"orderTerminal\":\"02\"}}",
  "clientId": "2022102018024210348",
  "sign": "C218E7E812B93FEA20FD8F16C646B3BFD36D5898FC682427CC5815C139EC1ED9",
  "signType": "SHA256",
  "version": "1.0"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| accId | string | 店铺唯一标识 |
| clientId | string | PingPong 商户号 |
| signType | string | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| code | string | 结果状态码，见附录状态码表: /notes/zh/appendix/successCodeList/ |
| description | string | 结果描述 |
| bizContent | string | 业务响应参数。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ transactionTime | string | 签约时间 |
| └─ threeDUnionParams | string | 3ds地址 |
| └─ └─ threeDRedirectUrl | string | 3DS跳转地址 |
| └─ transactionId | string | PP签约流水号 |
| └─ threeDContinue | string | 是否需要 3DS (验证处理使用⻛控插件对接的商户使用): true:是; false:否; |
| └─ merchantTransactionId | string | 商户签约单号 |
| └─ status | string | 签约状态，如果需要做3ds，签约状态为 INIT |

### 响应示例

```json
{
  "accId": "2022102018024210348883",
  "bizContent": "{\"transactionTime\":\"1716979873000\",\"threeDUnionParams\":{\"threeDRedirectUrl\":\"https://test-acquirer-static.pingpongx.com/payment/threeDs.html?code=eyJhY3NVcmwiOiJodHRwczovL3gzZC1hbnktaW50LmNyZWRvcmF4Lm5ldC9jaGFsbGVuZ2UvcmVxdWVzdC9QSU5HUDk3OC8wZGNhYjk1NzAzYmIyMDQwOWYwOTcxZTA4ZTk1MjIzZDEyMDkiLCJ0aHJlZURTUmVzdWx0VXJsIjoibnVsbD90cmFuc2FjdGlvbklkPTIwMjQwNTI5NTAxMzkxNTUmbWVyY2hhbnRUcmFuc2FjdGlvbklkPVBNVC02MEtMTVk3OFRTMTcxNjk3OTg3MDczNCIsInJlcXVlc3RNZXRob2QiOiJHRVQiLCJjaGFubmVsIjoiQ0hBTk5FTCJ9\"},\"transactionId\":\"2024052950139155\",\"threeDContinue\":\"true\",\"merchantTransactionId\":\"PMT-60KLMY78TS1716979870734\",\"status\":\"INIT\"}",
  "clientId": "2022102018024210348",
  "code": "002000",
  "description": "Transaction processing",
  "sign": "2C1F98F56DB04ECEC7800E97B20D4A05153800CCD3BA52E7D3E60B49B0EB79BA",
  "signType": "SHA256"
}
```