国际信用卡以下简称 Credit Card

本地支付以下简称APM

国际信用卡支付

接入前提

1. 商户具备PCI资质，并通过PingPongCheckout验证。(PCI-DSS请发送邮件附件到acquire-risk@pingpongx.com并抄送gig-tech-acq@pingpongx.com)

2. 商户具有自行开发收银台的能力。

注意

该方案要求商户服务器自行保存、处理持卡人的信用卡信息，因此强制要求商户具备PCI-DSS认证。

交互流程

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

1. 步骤 1

   进入商户的结账页面后，初始化风控插件

2. 步骤 2

   监听卡号输入框，持卡人填写卡号，卡号发生改变或者输入卡号的框体失去焦点，触发初始化事件-complexInit

3. 步骤 3

   complexInit事件中，风控插件与PingPongCheckout服务端交互，返回jsGeneratedData参数

4. 步骤 4

   客户端提交订单和jsGeneratedData参数到商户服务端

5. 步骤 5

   商户服务端请求下单并支付，将jsGeneratedData和其他参数一并提交

6. 步骤 6

   PingPongCheckout服务端响应请求结果，根据返回结果决定是否进入3D流程

7. 步骤 7

   无需3D验证,商户可以执行自定义的逻辑，展示支付结果

8. 步骤 8

   需要3D验证

   1. 触发风控插件的3D验证事件,页面将被重定向到3D挑战页,持卡人需要填写3D验证信息
   2. 发卡行验证3D信息
   3. 发卡行响应验证结果给PingPongCheckout服务端
   4. 页面被重定向到商户填写的支付结果页

9. 步骤 9

   PingPongCheckout服务端推送支付结果,如何获取异步通知报文详见异步通知

API清单

下单并支付
异步通知
申请退款

客户端接入

接入风控插件

端到端接入需要风控JS来收集必要的信息对交易做决策，当持卡人成输入卡号完之后，风控插件将会调用PingPongCheckoutServer API发送卡号数据进行验证，

详见 3DS集成指南

服务端接入

创建订单并支付

请求下单并支付

处理响应

请求交易接口之后，PingPongCheckout 根据请求参数响应结果，商户应根据响应处理交易。 处理结果可能是中间态，需要接入异步通知处理交易状态。请前往异步通知

本地支付

交互流程

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

1. 步骤 1

   客户端下单

2. 步骤 2

   商户服务端请求下单并支付

3. 步骤 3

   若请求成功，PingPongCheckout响应结果有2种可能：

   • 二维码：按提示，扫码支付
   • url：跳转到APM支付通道方

4. 步骤 4

   在APM通道指定的页面完成支付

5. 步骤 5

   PingPongCheckout服务端推送支付结果,如何获取异步通知报文详见异步通知

6. 步骤 6

   商户收到通知之后，应返回code 200

API清单

下单并支付
异步通知
申请退款

服务端接入

创建订单并支付

请求下单并支付

客户端接入

服务端下单成功后,根据下单并支付响应参数做不同操作

参数	描述
paymentQrCode	展示二维码完成支付
paymentRedirectUrl	直接跳转