线下卡支付
约 1288 字大约 4 分钟
2025-06-24
主要参与方
PingPongCheckout的线下卡支付解决方案集成方案实现了SAAS收银机与POS设备通过云端服务进行通信，完成支付、查询、退款等交易流程。该方案采用REST API方式，通过明确的设备标识机制确保交易请求准确路由到指定的POS终端。
- SAAS收银机：发起交易请求，接收交易结果
- PingPong收单服务：作为中间层，处理请求路由和响应转发
- POS设备：执行实际的支付操作，处理卡片交易
API 清单
支付流程
发起支付请求
SAAS收银机向PingPong收单服务发送统一下单支付请求(unifiedPay) 请求中包含deviceSn和deviceModel参数，明确指定目标POS设备 同时包含cashierDeviceId标识收银机自身
注意
deviceSn,cashierDeviceId和deviceModel参数是为了确保支付请求被正确路由到指定的POS设备, 请确保参数填写正确, 否则可能导致支付失败或请求被路由到错误的POS设备
请求路由
PingPong收单服务接收请求并验证签名 根据deviceSn和deviceModel将支付请求路由到指定POS设备
支付处理
POS设备接收请求并执行支付操作(如刷卡、NFC支付等) 处理完成后，POS设备将结果返回给收单服务
结果返回
收单服务将支付结果返回给SAAS收银机,同步响应结果可能是PROCESSING状态,支付结果需要通过查询API进行获取, SAAS收银机接收结果并进行后续处理（如打印小票、更新订单状态等）
退款流程
发起退款请求
SAAS收银机向收单服务发送退款请求(refund) 对于POS交易退款，必须包含deviceSn和deviceModel参数 请求中包含原交易信息和退款金额
退款路由
收单服务验证请求并路由到指定POS设备 POS设备执行退款操作
结果返回
POS设备将退款结果返回给收单服务，同步响应结果可能是PROCESSING状态,支付结果需要通过查询API进行获取, 收单服务将退款受理结果返回给收银机