Hosted
# Hosted支持的收银台渲染方式
Hosted-JS-SDK
-
在指定的DOM节点中加载JS-SDK,嵌入PingPongCheckout的收银台页面,目前有两个版本的JS-SDK可供使用:
- JS-SDK-1.0 基于iframe的JS-SDK
- 基于 Web Component 技术,浏览器原生支持,更加轻量
- 将您的网站重定向到PingPongCheckout的收银台页面
# Hosted模式系统交互流程

以下对主要步骤做简要说明
- 客户端提交订单给商户服务端处理
- 商户服务端请求PingPongCheckout服务端,提交订单信息和其他必要参数
- PingPongCheckout服务端响应收银台构建要素
-
客户端初始化收银台
- Hosted-JS-SDK:初始化SDK
- Hosted-Redirect:跳转到PaymentUrl
- 收银台与PingPongCheckout服务端交互,成功之后将会渲染PingPongCheckout收银台
- 买家填写卡号和cvv等支付信息,提交支付信息
- 持卡人确认支付
- 如果是3D交易,还需要3D验证,否则直接展示交易结果
- 如何获取异步通知报文详见异步通知
- 收到异步通知需要响应http code200给PingPongCheckout
# 订单状态处理
建议
payResultUrl 依据异步通知/订单查询返回的 status 进行处理, 订单状态流程图
- 交易状态会通过下单接口指定的notificationUrl下发异步通知
- 如果长时间未收到订单处理结果可通过 PingPong 的 交易查询接口 补充获取订单结果,查询接口频率建议按照间隔时间递增调用。
# API清单
# 服务端接入
持卡人客户端在请求商户服务端下单之后,需要提交必要参数给PingPongCheckout服务端进行下单。 详见 下单接口
# 客户端接入
服务端请求下单接口响应成功后,可以在客户端渲染Hosted接入模式的收银台页面。
- 如何初始化JS-SDK请前往Hosted-JS-SDK
- 如何重定向请前往Hosted-Redirect
# 3DS
收银台模式下,商户可以在调用下单接口的时候,通过上送3DS参数executeThreeD来控制是强制进行3DS校验,还是交由PingPongCheckOut的风控决策决定是否要进行3DS校验。
详见 3DS集成指南
上次更新: 2023/12/26, 15:35:30
← 概览 Non-Hosted→