接入指南 接入指南
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • 接入指南
    • 接入准备
    • 快速启动
    • 开发指南
    • 接入方式
    • 工具
    • 附录
    • 术语
  • API文档
    • checkout
    • dispute
    • Tokenization
    • 异步通知
    • Marketplaces
    • Terminal integration API
  • Marketplaces
  • Accept in-person payments with Terminal
  • 覆盖国家
  • 风险管理
  • 对账服务
  • 支付方式
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • v4

Hosted

# Hosted支持的收银台渲染方式


Hosted-JS-SDK
  • 在指定的DOM节点中加载JS-SDK,嵌入PingPongCheckout的收银台页面,目前有两个版本的JS-SDK可供使用:
    • JS-SDK-1.0          基于iframe的JS-SDK
    • JS-SDK-2.0推荐
              基于 Web Component 技术,浏览器原生支持,更加轻量
Hosted-Redirect
  • 将您的网站重定向到PingPongCheckout的收银台页面

# Hosted模式系统交互流程

跳转模式交互流程


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

  1. 客户端提交订单给商户服务端处理
  2. 商户服务端请求PingPongCheckout服务端,提交订单信息和其他必要参数
  3. PingPongCheckout服务端响应收银台构建要素
  4. 客户端初始化收银台
    • Hosted-JS-SDK:初始化SDK
    • Hosted-Redirect:跳转到PaymentUrl
  5. 收银台与PingPongCheckout服务端交互,成功之后将会渲染PingPongCheckout收银台
  6. 买家填写卡号和cvv等支付信息,提交支付信息
  7. 持卡人确认支付
  8. 如果是3D交易,还需要3D验证,否则直接展示交易结果
  9. 如何获取异步通知报文详见异步通知
  10. 收到异步通知需要响应http code200给PingPongCheckout

# 订单状态处理

建议

payResultUrl 依据异步通知/订单查询返回的 status 进行处理, 订单状态流程图

  • 交易状态会通过下单接口指定的notificationUrl下发异步通知
  • 如果长时间未收到订单处理结果可通过 PingPong 的 交易查询接口 补充获取订单结果,查询接口频率建议按照间隔时间递增调用。

# API清单


下单接口
异步通知
申请退款

# 服务端接入

持卡人客户端在请求商户服务端下单之后,需要提交必要参数给PingPongCheckout服务端进行下单。 详见 下单接口

# 客户端接入

服务端请求下单接口响应成功后,可以在客户端渲染Hosted接入模式的收银台页面。

  • 如何初始化JS-SDK请前往Hosted-JS-SDK
  • 如何重定向请前往Hosted-Redirect

# 3DS

收银台模式下,商户可以在调用下单接口的时候,通过上送3DS参数executeThreeD来控制是强制进行3DS校验,还是交由PingPongCheckOut的风控决策决定是否要进行3DS校验。

详见 3DS集成指南

上次更新: 2024/01/10, 14:01:30
杭州乒乓智能技术有限公司 | Copyright © 2015-2026 checkout.pingpongx.com.All Rights Reserved.
  • 浅色模式