关联API: Hosted-JS-SDK 或 获取跳转收银台
- 收银台模式下，将通过⻚面勾选框来决定createToken 是否为 Y，无需接口上送。
- 商户需要传送 merchantUserId，来标识当前付款人身份。
- PingPongCheckout 根据商户上送的merchantUserId匹配token，无需商户上传
CardOnFile
约 584 字大约 2 分钟
2025-03-07
关键参数
| 参数字段 | 参数类型 | 参数属性 | 参数说明 |
|---|---|---|---|
| bizType | String(64) | C | 绑卡并交易或绑卡需要验证卡号的情况传固定值 CardOnFile，否则不传(使用这个值请联系技术支持) |
| merchantUserId | String(64) | M | 商户网站的持卡人 ID，全局唯一，游客模式或不存在的情况传null |
| createToken | String(1) | M | Y/N,是否创建token |
| token | String(16) | M | 卡信息标志 |
交互流程
步骤一：创建card token
关联API: token创建
- 上送参数 createToken=Y。
- 上送参数 merchantUserId，来标识当前持卡人身份。
- 上送参数 bizType=CardOnFile(可选)，进行卡校验。
步骤二：校验卡的要素（可选）
如果您想校验卡的有效性，或者需要同时进行绑卡和支付过程（传入的amount>=0）,必须设置bizType=CardOnFile。
步骤三：展示卡列表（可选）
同一个用户可能存在多张信用卡，为了优化支付体验，我们需要了列出指定customerId下的卡列表（只展示卡号前6后4）供支持卡人选择。
Non-Hosted
这个步骤由商户端完成，商户可以自行记录卡和token的关系列表， 也可以调用PingPongCheckout的卡列表接口。
复购场景
- 收银台模式（Hosted）：通过内嵌收银台收集 CVV 完成支付，详见 复购 CVV 收集收银台。
- API 模式（Non-Hosted）：商户服务端直接使用 token 调用下单接口，详见 复购 Non-Hosted。