商户接入指南 商户接入指南
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • V4-专业版 (opens new window)
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • V4-专业版 (opens new window)
  • 概述

    • 起步
    • 对接流程
    • 联调资源
  • 服务

    • Checkout

      • 概览
      • Hosted
      • Non-Hosted
      • APIs

    • 订阅

      • 概览
      • 接入流程
    • 线下付款码支付

      • 接入流程
    • Tokenization

      • 概览
      • 接入流程
        • 接入前提
        • 关键参数
        • 交互流程
      • APIs

    • 风险管理

      • 概览
      • Dynamic 3D Secure
      • Disputes
      • APIs

    • 一键支付

      • 概览
      • 接入流程
      • APIs

    • ApplePay

    • GooglePay

    • KYB

    • 支付链

    • 建站工具

    • 工具

  • 附录

  • v4

快捷支付(Tokenization)

# 接入前提

需要接入下列其中一种模式,以便于完成支付和信用卡绑定流程
Hosted
Non-Hosted

# 关键参数

参数字段 参数类型 参数属性 参数说明
bizType String(64) M 绑卡并交易或绑卡需要验证卡号的情况传固定值:
  1. 信用卡支付传---CardOnFile
  2. 本地钱包支付传-CodeGrant
merchantUserId String(64) M 商户网站的持卡人 ID,全局唯一
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: 下单并支付
  • 上送参数createToken=Y。
  • 上送参数merchantUserId,来标识当前付款人身份。
  • 上送参数bizType=CardOnFile/CodeGrant业务标识。

# 步骤二:使用token支付

提示

步骤一随交易授权需要付款人参与,完成步骤一后获得token。 步骤二使用token代替授权操作,无需付款人参与

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

  1. 客户端下单
  2. 商户服务端请求下单并支付
    1. 传入token
    2. 传入bizType=CardOnFile/bizType=CodeGrant
    3. 传入merchantUserId
  3. 下单并支付 API 同步响应支付结果
  4. 异步通知推送最终结果,如何获取异步通知报文详见异步通知
上次更新: 2024/02/19, 18:02:34

← 概览 解绑token→

杭州乒乓智能技术有限公司 | Copyright © 2015-2024 checkout.pingpongx.com.All Rights Reserved.
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式