支付宝线下支付(收单)商家收银系统集成接口文档详细阐述了如何将商户的系统与支付宝的线下支付功能进行整合。该文档针对的是二维码收单方式,商家可以利用这一方案实现高效、便捷的支付体验。
首先,接口设计基于安全的阿里云平台,确保支付网关的高可用性,其地址为http(s)://open.jdlwlkj.com/offline/api.jsp。接入过程中,商户需要提供几个关键参数:
1. 收款方PID:商家总部的合作者身份ID,可在支付宝后台获取。
2. 收款方KEY:商家总部的私钥,同样在支付宝后台获取,用于加密通信安全。
3. 可选参数包括收款方账号(seller_email),在下载清算文件时必需;分店ID(STORE_ID)和独立分支机构PID,有助于区分不同的店铺或收款渠道;以及收银终端ID(TERMINAL_ID),用于标识特定的支付设备。
二维码支付是核心部分,商户需准备显示或打印设备,顾客通过扫描二维码完成支付。商家在发起支付时,需要提供以下参数:
- 服务名称(service):固定为"pay",表示进行支付操作。
- 订单总金额(fee):精确到小数点后两位。
- 操作员ID(operator_id):可选,用于记录操作员信息。
- 订单号(out_trade_no):顾客支付时的唯一标识,也可选填。
- 商品详情(goods_detail):订单中商品的详细信息,格式为JSON,例如包含商品ID、名称、价格和数量。
接口调用时,商户将这些参数以指定格式组合,如`id=123456789&service=pay&fee=0.01&operator_id=OP001&out_trade_no=20141213141516`,然后发送到支付网关。接口返回的响应参数包含了支付处理的结果代码,这对于商户跟踪交易状态至关重要。
这份文档提供了商家与支付宝集成二维码支付功能的具体指导,帮助商户设置参数、管理交易流程,并确保数据安全,提升线下业务的数字化管理水平。