Non-hosted 国际信用卡支付
约 1019 字大约 3 分钟
2025-03-07
| 下单支付(即时扣款) | 预授权(先冻结后确认) | 部分请款 | 退款与部分退款 | 记住卡号 | 重新支付 | CardOnFile | Recurring | 首笔0元 Recurring | 3DS |
|---|---|---|---|---|---|---|---|---|---|
接入前提
商户具备PCI资质,并通过PingPongCheckout验证。(PCI-DSS请发送邮件附件到
acquire-risk@pingpongx.com并抄送gig-tech-acq@pingpongx.com)商户具有自行开发收银台的能力。
注意
该方案要求商户服务器自行保存、处理持卡人的信用卡信息,因此强制要求商户具备PCI-DSS认证。
交互流程
进入商户的结账页面后,初始化 SafePayGuardJs 和 SecureShieldJs 插件
初始化风控插件,为后续操作做准备
监听卡号输入框,持卡人填写卡号
当卡号发生改变或输入框失去焦点时,触发初始化 SecureShieldJs 中事件 triggerThreeDsInit,风控插件与 PingPongCheckout 服务端交互,返回部分 jsGeneratedData 和 browserInfo参数
用户点击支付
调用 SafePayGuardJs 和 SecureShieldJs 中的 getGeneratedData 方法获取风控参数
客户端提交订单信息
下单并支付,将 SafePayGuardJs 和 SecureShieldJs 插件中收集的 jsGeneratedData、browserInfo 和其他参数一并提交
PingPongCheckout 服务端请求发卡行接口
将支付信息发送给发卡行处理
发卡行返回支付结果给 PingPongCheckout
处理支付请求后返回结果
PingPongCheckout 服务端同步请求结果
接收并处理发卡行返回的结果
商户客户端根据返回结果决定后续流程
根据 bizContent.threeDContinue 决定是否进入3D流程:
- 无需 3D 验证:商户可以执行自定义的逻辑,展示支付结果
- 需要跳转 3D 验证:根据 bizContent.threeDUnionParams.threeDRedirectUrl 跳转3D挑战页,完成验证后 PingPongCheckout 会重定向到 payResultUrl
API清单
客户端接入
接入风控插件
端到端接入需要风控JS来收集必要的信息对交易做决策,当持卡人成输入卡号完之后,风控插件将会调用PingPongCheckoutServer API发送卡号数据进行验证,
详见 3DS集成指南
服务端接入
创建订单并支付
请求下单并支付
处理响应
请求交易接口之后,PingPongCheckout 根据请求参数响应结果,商户应根据响应处理交易。 处理结果可能是中间态,需要接入异步通知处理交易状态。请前往异步通知
