---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/notify/bindNotify/cof/accTokenCreation/index.md
description: >-
  签约成功通知接口用于在用户完成支付账户绑定后，向商户系统发送异步通知。适用于需要实时了解用户支付账户绑定状态的场景，支持全球范围内的支付服务接入。关键特性包括通过HTTPS
  POST方式传递数据，确保信息传输的安全性；消息体包含签约结果、用户标识等重要参数，便于商户进行后续处理。
---
# 用户绑卡成功通知

```apidef
endpoint: POST tokenization.cof.accTokenCreation
name: 用户绑卡成功通知
summary: 国际信用卡绑卡成功异步回调
variant: 国际信用卡
tags: Notify, Tokenization, CardOnFile
```

签约成功通知接口用于在用户完成支付账户绑定后，向商户系统发送异步通知。适用于需要实时了解用户支付账户绑定状态的场景，支持全球范围内的支付服务接入。关键特性包括通过HTTPS POST方式传递数据，确保信息传输的安全性；消息体包含签约结果、用户标识等重要参数，便于商户进行后续处理。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | PingPong 店铺号 |
| clientId | string | M | PingPong 商户号 |
| code | string | M | 状态码 |
| description | string | M | 描述 |
| sign | string | M | 签名 |
| signType | string | M | 签名规约，支持 MD5、SHA256，具体见本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏，所有参数均参与签名 |
| bizContent | string | M | 响应参数作为整体传入，长度不限。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ exchangedCurrency | string | M | 换汇币种 |
| └─ threeDSInfo | object | O | 3ds参数 |
| └─ └─ authenticationResult | string | O | 3DS验证结果，枚举值如下: Y：验证通过; A: 持卡人未参与，但尝试进行身份验证的记录已被录入; N：验证失败; |
| └─ └─ liabilityShift | string | O | 责任转移，示例值：Y/N |
| └─ └─ eci | string | O | 仅对 Visa、American Express、ICB、Diners Club 和Discover 的交易才会返回。当身份验证失败时，该字段为空。该字段包含以下值之一: 01:尝试身份验证 (Mastercard) 01:; 02:成功身份验证 (Mastercard); 05:成功身份验证 (Visa、American Express、JCB、Diners Club 和 Discover); 06: 尝试身份验证 (Visa、American Express、JCB、Diners Club 和 Discover); |
| └─ └─ authentication3DSecure | string | O | threeDSServerTransactionId / directoryServerTransactionId 不为空 |
| └─ └─ specificationVersion | string | O | 3DS版本 |
| └─ └─ cavv | string | O | cavv |
| └─ amount | string | M | 签约金额，0 |
| └─ authenticationInfo | object | O | 身份认证信息 |
| └─ └─ avsResult | string | O | 枚举值如下： Y（AVS full match）; A（AVS street address only）; Z（AVS postal/zip code only）; N（AVS nonmatch）; R（AVS indeterminate outcome (retry)）; U（AVS unable to verify）; |
| └─ └─ cvvResult | string | O | cvv验证结果 |
| └─ └─ threeDSecure | string | O | 是否进行3DS验证，Y/N |
| └─ cardInfo | object | O | 签约绑定的卡信息 |
| └─ └─ cardLevel | string | M | 卡交易·卡级别 |
| └─ └─ cardType | string | M | 卡交易·`卡类型,枚举值： DEBIT; CREDIT; CHARGE; CARD; |
| └─ └─ firstName | string | M | 持卡人名称，字符类型，不含特殊符号 |
| └─ └─ lastName | string | M | 持卡人姓，字符类型，不含特殊符号 |
| └─ └─ firstSixDigits | string | M | 卡号前6位 |
| └─ └─ lastFourDigits | string | M | 卡号后4位 |
| └─ └─ ipCountry | string | M | 用户交易国家 |
| └─ └─ isoCountry | string | M | 发卡行国家 |
| └─ └─ issuringBank | string | M | 发卡行 |
| └─ └─ isoCountryA2 | string | C | 国家二字码，符合iso3166标准 |
| └─ └─ paymentBrand | string | M | 卡交易·卡品牌：VISA / Mastercard / American Express/ JCB / Discover |
| └─ threeDSecure | string | M | 3D标识： Y; N; |
| └─ transactionTime | string | M | 签约时间 |
| └─ transactionId | string | M | PingPong 签约流水号 |
| └─ token | string | M | 授权token |
| └─ notifyType | string | M | 通知类型 |
| └─ requestId | string | M | 唯一请求号，全局唯一 |
| └─ merchantTransactionId | string | M | 商户单号 |
| └─ paymentMethod | string | M | 要使用的付款方式的类型和所需的详细信息 |
| └─ └─ type | string | M | 卡类型 |
| └─ currency | string | M | 交易币种 |
| └─ exchangedAmount | string | O | 换汇金额 |
| └─ captureDelayHours | integer | C | 0表示立即capture; -1表示手动capture，调用统一下单API成功之后还需要调用下预授权请款: /notes/zh/checkout/api/modifications/capture/ ,本地支付不支持; |
| └─ status | string | M | 状态 |

### 请求示例

```json
{
  "clientId": "2022102018024210348",
  "code": "000000",
  "bizContent": "{\"exchangedCurrency\":\"USD\",\"threeDSInfo\":{\"cavv\":\"AJkBAoEREQAAAAB4hABwcAAAAAA=\",\"authenticationResult\":\"Y\",\"liabilityShift\":\"Y\",\"eci\":\"05\",\"authentication3DSecure\":\"119ee498-d4d6-4283-9775-6b39c48d4657\",\"specificationVersion\":\"\"},\"amount\":\"0.000000\",\"authenticationInfo\":{\"avsResult\":\"Unknown\",\"cvvResult\":\"Y\",\"threeDSecure\":\"Y\"},\"cardInfo\":{\"firstName\":\"James\",\"lastName\":\"LeBron\",\"lastFourDigits\":\"0015\",\"paymentBrand\":\"Mastercard\",\"firstSixDigits\":\"529991\"},\"threeDSecure\":\"Y\",\"transactionTime\":\"1716978201000\",\"transactionId\":\"2024052950139153\",\"token\":\"97b4e5b9fb4e53727ef7cbf0b25a3d42\",\"notifyType\":\"RECHARGE\",\"requestId\":\"PMT-PGGGNIPC0P1716978198933\",\"merchantTransactionId\":\"PMT-PGGGNIPC0P1716978198933\",\"paymentMethod\":{\"type\":\"Mastercard\"},\"currency\":\"USD\",\"exchangedAmount\":\"0.000000\",\"captureDelayHours\":0,\"status\":\"SUCCESS\"}",
  "sign": "628020D85280D57C100DDCEC64930B5B19EDC99E51EA849A0A90A8FAA4A52C8D",
  "accId": "2022102018024210348883",
  "description": "Transaction succeeded",
  "signType": "SHA256"
}
```