端到端模式
# 快速开始
商户与 PingPongCheckout 完全通过API来进行交互,商户需自行开发收银台页面,保存、处理持卡人的信用卡信息。
注意 :
在交易进行中,为了更好地帮助商户提前规避风险,若PingPongCheckout 风控系统识别出订单风险存疑,
会在客户端展示交易状态为“status=REVIEW”,PingPongCheckout将会对订单进行人工审核,商户可以对订单审核结果提出建议。
# 接入前提
商户具备PCI资质,并通过PingPongCheckout验证。(PCI-DSS请发送邮件附件到
acquire-risk@pingpongx.com并抄送gig-tech-acq@pingpongx.com)商户具有自行开发收银台的能力。
注意 :
该方案要求商户服务器自行保存、处理持卡人的信用卡信息,因此强制要求商户具备PCI-DSS认证。
# 如何接入
# 接入riskJs组件
端到端接入需要风控JS来收集必要的信息对交易做决策,当持卡人成输入卡号完之后,riskJs组件将会调用PingPongCheckoutServer API发送卡号数据进行验证,
# 创建订单
请求端到端直连API
# 异步响应
| 参数字段 | 参数属性 | 参数说明 |
|---|---|---|
| accId | M | PingPong 商户店铺编号 |
| transactionId | M | PingPong 交易流水号 |
| merchantTransactionId | M | 商户网站的的交易流水号 |
| code | M | 结果状态码 |
| description | M | 结果描述 |
| paymentType | M | 交易类型: DEBIT-直接付款 AUTH-预授权 |
| currency | M | 交易币种 |
| amount | M | 交易金额 |
| transactionTime | M | 交易发起时间 |
| status | M |
|
| signType | M | 签名规约,支持 MD5、SHA256,具体⻅本文“签名规约” 一栏 |
| sign | M | 签名内容,具体⻅本文“签名规约”一栏 |
| remark | C | 商户扩展字段 |
| threeDSecure | C | 3DS 交易标示 Y/N |
# 处理响应
请求交易接口之后,PingPongCheckout 根据请求参数响应结果,商户应根据响应处理交易。 处理结果可能是中间态,需要接入异步通知处理交易状态。
交易结果分4种情况:
- 交易成功 交易结束
- 3DS 需引导客户前往3DS页面进行验证
- 交易处理中 需要从异步通知中获取最终结果
- 交易失败 交易结束
详见如何获取交易状态
上次更新: 2023/04/20, 12:02:55