线下支付场景之反扫支付

        很多老板都在后台私信小编，你们平台这些支付功能确实不错，但只局限于线上网站的场景，可我们没有技术，只是线下来收收款，有没有这方面的产品？

        当然有！！我们不仅专注于线上的支付场景，而且线下也提供反扫支付和台牌码支付功能，反扫指商家使用扫码枪、收银扫码器等设备，扫描顾客出示的支付码，进行交易。下面小编我就来简单介绍一下我们的反扫支付功能。

1.产品介绍

1.1简介

反扫指商家使用扫码枪、收银扫码器等设备，扫描顾客出示的支付码，进行交易。

系统的反扫支付服务更适用于大型商城、超市、连锁店等场所，商户可以将反扫服务集成到自有收银系统或收款设备中，消费者消费时，出示付款二维码，商家使用扫码设备进行扫码收款。

支付机构提供扫码支付开通或修改、支付配置功能，聚合了支付宝、微信、银联二维码（云闪付）、数字货币支付等主流支付通道。并将交易信息反馈到商户业务系统中，实现信息流与资金流的统一。

1.2应场景

适用对象：开通微信、支付宝、银联二维码（云闪付）、数字人民币权限的商户；

我们支持：

1. 手续费配置（内扣、外扣、实收、后收、线上、线下）；
2. 支持间连和直连扫码类型、支持指定子账户入金、支持ATU代金券；

反扫支付示例：

商家通过扫码设备，扫描消费者出示的付款码完成收款；

流程图：

1.3名词定义及说明

【反扫】指客户出具二维码，由商家利用扫码设备扫描二维码进行收款的支付方式；

2.接入前准备

2.1商务准备

1. 选择接入模式
2. 服务商模式：指服务商与支付机构签约，服务商通过接口或控台方式完成商户入网。具体流程：服务商完成协议签署后，将准备好的入网材料提供给支付机构人员，由支付机构人员发起服务商入网申请，待审核通过入网成功后，服务商联系人将收到短信通知控台账号及密码。
3. 在系统完成商户进件入网

• 控台入网：参考服务商控台进件流程；
• API入网：企业商户调用 企业商户基本信息入驻接口 、小微商户调用 个人商户基本信息入驻接口 完成开户、绑卡、结算配置。

2.2对接准备

第一步：密钥获取

联调之前需要先获取公私钥（记得私信哦~）；

第二步：公共参数获取

登录商户控台后，可在开发设置-开发者信息中，获取sys_id，product_id参数信息；

第三步：业务开通及配置

步骤一：服务商功能及权限开通。服务商通过线下签约方式申请支付宝或微信、银联云闪付功能，支付机构人员在审核好服务商资料之后，为服务商开通相关支付功能，及费率配置。

步骤二：为商户开通功能及权限。服务商权限及费率配置完成后，服务商可在服务商控台为下属商户申请开通相关支付功能，或通过调用商户业务开通接口开通。具体流程请参考商户进件API文档。

3.开发指引

3.1对接规范

调用接口，均采取POST形式提交，数据格式统一为JSON格式（记得私信哦~）；

3.2确认业务配置

控台查询微信、支付宝、银联二维码支付是否配置完成

1.渠道商控台-【商户管理】-【商户信息】-基础支付配置

2、路径：渠道商控台-【商户管理】-【商户支付功能管理】-查看数字货币

3、商户控台-【我的信息管理】-【我的信息】-业务信息

也可以通过商户详细信息查询接口来确认相关配置。

3.3系统调用流程

3.3.1交易流程

1. 消费者打开微信、支付宝、银联、数字货币APP，展示付款码；
2. 商户收银员通过扫码枪等收银工具扫码读取付款码信息；
3. 商户业务系统调用后台的【聚合反扫接口】将业务订单信息、微信/支付宝/银联/数字货币的付款码、设备信息传入即可

聚合反扫接口需关注以下字段：

参数	中文名	必填	说明
auth_code	支付授权码	Y	收银设备读取的付款码
wx_data	微信参数集合	N	按微信要求填写
alipay_data	支付宝扩展参数集合	N	按支付宝要求填写
unionpay_data	银联参数集合	N	按银联要求填写
risk_check_data	安全信息	Y	机具的ip或经纬度
terminal_device_info	设备信息	N	设备信息
notify_url	异步通知地址	N	交易异步通知地址，http或https开头

同步返回关注以下字段：

参数	中文名	说明
trans_stat	交易状态	同步通常返回“处理中”，交易终态以异步返回为准
resp_desc	业务响应信息	关注失败原因
bank_message	通道返回描述	关注通道返回的失败原因
hf_seq_id	全局流水号	系统生成全局流水号，后续可以用这个流水号查询交易

客户支付完成后系统会将支付结果推送到客户异步地址，主要关注参数如下

参数	中文名	说明
settlement_amt	结算金额	用户实际支付金额。如有优惠该金额小于交易金额；
fee_amount	手续费金额	系统扣收的支付手续费金额
trans_stat	交易状态	交易的最终结果；S：成功、F：失败
out_trans_id	用户账单上的交易订单号	交易在微信侧的流水号
party_order_id	用户账单上的商户订单号	交易在微信侧生成的订单号

如果长时间未收到异步结果可以调用扫码交易查询接口查询交易状态；

3.3.2退款流程

完整的交易流程还要包括退款。由于用户或者商户的原因需要退款时，商户可以通过本接口将支付款退还给用户，退款成功资金将原路返回。

参数	中文名	必填	说明
org_req_date	原交易请求日期	Y	用户发起支付的日期
org_req_seq_id	原交易请求流水号	C	商户系统发给系统的指令流水号
org_XXX_seq_id	原交易全局流水号	C	支付机构生成的系统流水号
org_party_order_id	原交易微信支付宝的商户单号	C	该笔交易在微信端的流水号
ord_amt	申请退款金额	Y	退款金额<=原交易金额

• 原交易请求流水号、原交易全局流水号、原交易微信支付宝的商户单号三选一即可；
• 退款金额不能大于交易金额；由于接口支持多次部分退款，多次退款场景下退款总额不能高于原交易金额；
• 退款也是以异步返回的成功或失败状态为最终结果；
• 一些特殊场景下退款时效可能比较长，注意接口描述文档中的退款时效说明

3.3.3对账流程

为了满足商户财务的对账需求，系统提供了对账功能。

方案一：控台下载；

方案二：接口获取；

接口下载的对账文件包括以下四类：

• 日对账单类型：包括日结算对账单、日分账对账单、日出金对账单；
• 日交易数据：主要是各种支付交易记录；
• 月结算对账单：按月汇总的结算对账单；
• 月交易数据：按月汇总支付交易记录；

3.3.4异步通知

针对交易结果，支付机构会通过异步消息的方式通知客户系统。

调用支付机构接口时上送的异步通知地址为http/https路径：服务器为POST回调，默认超时时间为5秒，超时后会重试3次；不支持HTTP重定向；服务器对应答不是200~300之间的错误，会默认重试3次；异步通知服务器对HTTPS不认证验签和ALLOW_ALL_HOSTNAME_VERIFIER；如商户自定义通知端口，请使用8000-9005内端口，否则无法通知；URL 上请勿附带参数；异步回调请求编码集为：UTF-8；收到通知后请返回状态码“200”,响应异步通知。

注意事项：

同样的异步消息可能会通知多次，因此接收异步消息的处理需做好幂等，保障多次接收到同样的消息处理后结果不变。

在实现异步消息接收的同时，都建议您在重要的业务环节，通过反查接口确认 非终态 支付订单的状态，以保证在发生异步消息延迟或无法送达情况下的支付结果一致性。