服务端复购(Token 支付 / 一键支付)
约 867 字大约 3 分钟
2025-05-15
适用场景
- 商户自行管理卡列表和支付交互,不需要 PingPong 收银台
- 商户已在本地维护 token 与卡信息的映射关系
- 后续支付由持卡人在场发起,适合一键支付场景
前提条件
- 已完成 首次支付并保存卡 流程,并获取到可用于复购的支付凭证 token
- 已了解首笔保存卡交易时是否传入了
bizType=CardOnFile - 已在商户侧完成保存卡及后续使用授权的告知
交互流程
接入步骤
客户端下单
客户在商户平台发起订单创建
商户服务端请求下单并支付
调用 下单并支付 接口
- 传入支付凭证
token - 如果创建 token 时传入了
bizType=CardOnFile,那么后续使用 token 交易时每一笔也都需要继续传送
PingPong 平台规则:bizType=CardOnFile 继承规则
首笔保存卡时传入了
bizType=CardOnFile→ 后续所有基于该 token 的复购都必须继续传入bizType=CardOnFile。 首笔未传 → 后续无需传,也不能传。后续 token 复购请求关键字段示例:
bizContent 关键字段(CardOnFile 场景){ "merchantUserId": "USER_12345", "token": "TOKEN_123456", "bizType": "CardOnFile" }- 传入支付凭证
注意
后续无需输入 CVV,并不代表交易一定不会被要求额外认证。实际是否触发 3DS、challenge 或被拒绝,仍取决于发卡行风控、监管要求以及交易风险。
字段区分
此处上传的 token 为支付凭证 token,由首笔保存卡成功后返回;后续服务端复购时,继续在 uniformly 请求中通过 token 字段传入。
:::
相关文档
- 首次支付并保存卡 — 首次支付并保存卡信息,获取后续可复用凭证
- 收银台复购(已保存卡 + CVV) — 通过收银台收集 CVV 完成复购
- 下单并支付接口 — Non-Hosted 模式核心 API
