---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/tokenization/oneClickPayment/bind/index.md
description: >-
  签约接口用于实现用户银行卡信息的令牌化存储，支持后续快速支付。适用于电商平台、移动应用等场景，提高支付安全性与便捷性。主要功能包括生成和管理卡片令牌，关键参数有商户ID、用户ID及卡信息。
---
# 签约获取凭证

```apidef
endpoint: POST /v4/paymethod/bind
name: 签约获取凭证
summary: APM 签约获取凭证
variant: APM
tags: Tokenization, APM
```

签约接口用于实现用户银行卡信息的令牌化存储，支持后续快速支付。适用于电商平台、移动应用等场景，提高支付安全性与便捷性。主要功能包括生成和管理卡片令牌，关键参数有商户ID、用户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 |
| └─ paymentMethod | object | M | 支付方式 |
| └─ └─ type | string | M | 支持的支付方式枚举：
Boost; GCash; TNG eWallet; DANA; Kakaopay; True Money; AlipayHK; Alipay; Rabbit LINE Pay; |
| └─ merchantResultUrl | string | M | 商户结果页地址 |
| └─ notificationUrl | string | M | 商户通知地址。
地址建议：请填写基于公网域名的完整 URL，推荐使用标准 Web 端口（HTTPS 默认 443，HTTP 默认 80），并确保该地址可稳定接收 PingPongCheckout 的异步通知。 |
| └─ device | object | M | 设备参数 |
| └─ └─ orderTerminal | string | O | 01-H5; 02-PC; 04-iOS; 05-ANDROID; |
| └─ bizType | string | M | 固定值：CodeGrant |

### 请求示例

```json
{
  "accId": "2022102018024210348883",
  "bizContent": "{\"merchantUserId\":\"126048964333251315123\",\"requestId\":\"PMT-SM2NG9AEOV1716798866107\",\"merchantResultUrl\":\"https://test-acquirerpay.pingpongx.com/qa/result.html\",\"notificationUrl\":\"https://test-acquirerpay.pingpongx.com/qa/result.html\",\"bizType\":\"CodeGrant\",\"paymentMethod\":{\"type\":\"Alipay\"},\"device\":{\"orderTerminal\":\"02\"}}",
  "clientId": "2022102018024210348",
  "sign": "29DEE85CCEFE3C9BCE870BE5D3573B76EA89997287A07BBAC7599621A00719C1",
  "signType": "SHA256",
  "version": "1.0"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| sign | string | 签名值 |
| bizContent | string | 业务参数。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ token | string | 令牌token |
| └─ authUrl | string | 签约链接 |
| signType | string | 签名方式 |
| code | string | 结果状态码 |
| description | string | 结果描述 |

### 响应示例

```json
{
  "bizContent": "{\"token\":\"196876a82e5bfb40f1fee402fec92f52\",\"authUrl\":\"https://g.alipayplus.com/page/aplus-linker/acwallet/authorization.html?scopes=AGREEMENT_PAY%2CUSER_LOGIN_ID&bizContent=%7B%22acquirerId%22%3A%22Z02TE5520000000A%22%2C%22authClientDisplayName%22%3A%22BL%20Company%22%2C%22authClientId%22%3A%222022102018024210348%22%2C%22authClientName%22%3A%22BL%20Company%22%2C%22authRedirectUrl%22%3A%22https%3A%2F%2Fg.alipayplus.com%2Fpage%2Fac-auth-payment%2Fresult%2Fmobile%2Findex.html%3FloadMode%3D2%26callbackType%3DCommon%26terminalType%3DWEB%26referenceAgreementId%3D1716444968758634%26authRequestId%3D2024052319091305000190000395242%26pspId%3DT56264108532298562A%26clientId%3DSANDBOX_5Y60882YJZ2405725%22%2C%22authState%22%3A%221716444968758634%22%2C%22customerBelongsTo%22%3A%22BOOST%22%2C%22pspId%22%3A%22T56264108532298562A%22%2C%22referenceAgreementId%22%3A%221716444968758634%22%2C%22referenceMerchantId%22%3A%222022102018024210348%22%2C%22scopes%22%3A%5B%22AGREEMENT_PAY%22%2C%22USER_LOGIN_ID%22%5D%2C%22terminalType%22%3A%22WEB%22%7D&source=AlipayConnect&needCallback=true\"}",
  "sign": "102897C8BF0AA4B9C2D78CE20800FD2E2288856CF1C76A18BC985954A4B36390",
  "signType": "SHA256"
}
```