当面付解决方案

1、支付宝（当面付）解决方案版本号：2.0支付宝（中国）网络技术有限公司 版权所有支付宝（当面付）解决方案目 录1 商户背景22 业务流程32.1 完整交易流程32.1.1 条码支付（终端扫用户）32.1.2 扫码支付（用户扫终端）52.1.3 退款82.1.4 单边账、冲正103 集成113.1 对账113.2 开发语言113.3 项目排期113.4 其他规范114 测试121 商户背景2 业务流程2.1 完整交易流程2.1.1 条码支付（终端扫用户）流程说明：以上流程需要用到的接口：1、 统一下单并支付接口(alipay.acquire.createandpay)a) 下单接口中订单支付超时时

2、间（it_b_pay）请设置为1分钟。b) 在提交下单接口后触发轮询支付宝查询接口逻辑，间隔为5秒钟，若超时用户未付款，则由前置机发起撤销动作，在撤销前，前置机必须最后做一次查询操作，防止终端最后一次查询和前置机撤销之间有延时，导致把用户已支付的交易撤销了。c) 收到支付宝回传的数据必须做验签，个别参数例如fund_bill_list，正确的拼装格式是不解析内部xml节点，直接key value，示例如：&fund_bill_list=<fund_bill_list><TradeFundBill><amount>0.01</amount>

3、<fund_channel>10</fund_channel></TradeFundBill></fund_bill_list>&d) 业务扩展参数中的门店ID、终端编号ID、Agent_ID必须传入 2、 收单查询接口(alipay.acquire.query)在调用下单接口之后如果未能立即返回支付成功，则间隔5秒轮询该接口，直到收到用户已付款的状态为止，最长轮询时间建议1分钟3、 收单撤销接口(alipay.acquire.cancel)当查询一分钟还未能收到已支付的结果，则调用该接口关闭此订单。撤销接口实现之后也必须让商户要有重试机

4、制，规范是5秒2次，直到该接口能够同步响应结果为止。2.1.2 扫码支付（用户扫终端）流程说明：以上流程需要用到的接口：1、 统一预下单接口(alipay.acquire.precreate)e) 预下单接口中订单支付超时时间（it_b_pay）请设置为2分钟。f) 在提交预下单接口后触发轮询支付宝查询接口逻辑，间隔为5秒钟，若此时用户未扫码，会返回交易不存在，若用户扫码会返回等待买家付款状态，若超过2分钟用户未付款，则由前置机发起撤销动作，在撤销前，前置机必须最后做一次查询操作，防止终端最后一次查询和前置机撤销之间有延时，导致把用户已支付的交易撤销了。g) 收到支付宝回传的数据必须做验签，个

5、别参数例如fund_bill_list，正确的拼装格式是不解析内部xml节点，直接key value，示例如：&fund_bill_list=<fund_bill_list><TradeFundBill><amount>0.01</amount><fund_channel>10</fund_channel></TradeFundBill></fund_bill_list>&h) 业务扩展参数中的门店ID、终端编号ID、Agent_ID必须传入 2、 收单查询接口(alipay.acq

6、uire.query)在调用下单接口之后如果未能立即返回支付成功，则间隔5秒轮询该接口，直到收到用户已付款的状态为止，最长轮询时间建议2分钟3、 收单撤销接口(alipay.acquire.cancel)当查询一分钟还未能收到已支付的结果，则调用该接口关闭此订单。撤销接口实现之后也必须让商户要有重试机制，规范是5秒2次，直到该接口能够同步响应结果为止。2.1.3 退款流程说明：以上流程需要用到的接口：1、 收单退款接口(alipay.acquire.refund)a) 退款接口支持全额退款和部分退款。b) 退款金额不能超过原始订单的交易总金额。c) 退款到用户是原路返回，用户如果使用银行卡快捷

7、，就会直接返回到银行卡，根据银行到账时间T+N。d) 如果退款发生失败，并且商户发起的支付宝账号是有余额能够支付退款的，则重试2次退款，还是不行就人工介入，可以联系支付宝服务支持或技术支持解决。2.1.4 单边账、冲正流程说明：以上流程需要用到的接口：1、 收单撤销接口(alipay.acquire.cancel)a) 撤销接口正常调用都是返回成功状态，所以要判断参数是否有资金变动，如果有资金变动则认为是撤销交易成功，无资金变动表示该交易不存在或者已经被关闭了。b) 如果返回结果报错，可以重试，如果重试2次还是报错，人工介入，联系支付宝。3 集成3.1 对账商户如果是直接与支付宝签约，可以由B

8、D开通对账接口，如果是渠道商直接签约的下家，是不能申请对账接口的。3.2 开发语言3.3 项目排期3.4 其他规范1、 系统交互模块需要商户做必要的容错，系统一定要健壮，不能因为支付宝改动了任何一个参数就系统奔溃或者影响用户能够正常完成的交易2、 必须做灾备机制，有一个备用服务器3、 小票必须带有支付宝的交易号或者商户的订单号，必须有优惠金额等信息4、 日志：POS端日志：把提交参数 xml记下来，考虑日志大小及时清理服务端日志：记录POS收到的时间和 返回时间；当发生错误及异常的情况下，必须对该订单做详细的记录，以便双方技术人员事后排查并解决。5、 个性化：查询的轮询工作放在终端平板上实现，减少前置机的轮询压力，最后一次查询是放在前置机，未支付则调用撤