关键参数

参数字段	参数类型	参数属性	参数说明
bizType	String(64)	C	绑卡并交易或绑卡需要验证卡号的情况传固定值 CardOnFile，否则不传(使用这个值请联系技术支持)
merchantUserId	String(64)	M	商户网站的持卡人 ID，全局唯一，游客模式或不存在的情况传null
createToken	String(1)	M	Y/N,是否创建token
token	String(16)	M	卡信息标志

交互流程

步骤一：创建card token

Hosted

关联API: Hosted-JS-SDK或获取跳转收银台

• 收银台模式下，将通过⻚面勾选框来决定createToken 是否为Y ，无需接口上送。
• 商户需要传送merchantUserId，来标识当前付款人身份。
• PingPongCheckout 根据商户上送的merchantUserId匹配token，无需商户上传

Non-Hosted

关联API: token创建

• 上送参数createToken=Y。
• 上送参数merchantUserId，来标识当前持卡人身份。
• 上送参数bizType=CardOnFile(可选)，进行卡校验。

步骤二：校验卡的要素（可选）

如果您想校验卡的有效性，或者需要同时进行绑卡和支付过程（传入的amount>=0）,必须设置bizType=CardOnFile。

步骤三：展示卡列表（可选）

同一个用户可能存在多张信用卡，为了优化支付体验，我们需要了列出指定customerId下的卡列表（只展示卡号前6后4）供支持卡人选择。

Non-Hosted

这个步骤由商户端完成，商户可以自行记录卡和token的关系列表， 也可以调用PingPongCheckout的卡列表接口。

步骤四：使用card token支付

以下对主要步骤做简要说明

1. 客户端下单
2. 商户服务端请求下单并支付
   • 传入token
   • 如果创建token时候传入了bizType=CardOnFile，那么后续使用token交易时候每一笔都需要传送
3. 下单并支付 API 同步响应支付结果
4. 异步通知推送最终结果,如何获取异步通知报文详见异步通知