当面付解决方案

Alipaycom支付宝（当面付）解决方案版本号：2.0支付宝（中国）网络技术有限公司版权所有目录TOC\o"1-5"\h\z\o"CurrentDocument"1商户背景2\o"CurrentDocument"2业务流程3\o"CurrentDocument"2.1完整交易流程32.1.1条码支付（终端扫用户）32.1.2扫码支付（用户扫终端）52.1.3退款82.1.4单边账、冲正10\o"CurrentDocument"3集成11\o"CurrentDocument"3.1对账11\o"CurrentDocument"3.2开发语言11\o"CurrentDocument"3.3项目排期11\o"CurrentDocument"3.4其他规范11\o"CurrentDocument"4测试121商户背景2业务流程2.1完整交易流程2.1.1条码支付（终端扫用户）流程说明:以上流程需要用到的接口：1、统一下单并支付接口（alipay.acquire.createandpay）a）下单接口中订单支付超时时间（it_b_pay）请设置为1分钟。b）在提交下单接口后触发轮询支付宝查询接口逻辑，间隔为5秒钟，若超时用户未付款，则由前置机发起撤销动作，在撤销前，前置机必须最后做一次查询操作，防止终端最后一次查询和前置机撤销之间有延时，导致把用户已支付的交易撤销了。c）收到支付宝回传的数据必须做验签，个别参数例如fund_bill_list，正确的拼装格式是不解析内部xml节点，直接keyvalue，示例如：...&fund_bill_list=<fund_bill_list><TradeFundBill><amount>0.01</amount><fund_channel>10</fund_channel></TradeFundBill></fund_bill_list>&..d）业务扩展参数中的门店ID、终端编号ID、Agent_ID必须传入2、收单查询接口（alipay.acquire.query）在调用下单接口之后如果未能立即返回支付成功，则间隔5秒轮询该接口，直到收到用户已付款的状态为止，最长轮询时间建议1分钟3、收单撤销接口（alipay.acquire.cancel）当查询一分钟还未能收到已支付的结果，则调用该接口关闭此订单。撤销接口实现之后也必须让商户要有重试机制，规范是5秒2次，直到该接口能够同步响应结果为止。2.1.2扫码支付（用户扫终端）

流程说明：以上流程需要用到的接口：1、统一预下单接口(alipay.acquire.precreate)预下单接口中订单支付超时时间(it_b_pay)请设置为2分钟。在提交预下单接口后触发轮询支付宝查询接口逻辑，间隔为5秒钟，若此时用户未扫码，会返回交易不存在，若用户扫码会返回等待买家付款状态，若超过2分钟用户未付款，则由前置机发起撤销动作，在撤销前，前置机必须最后做一次查询操作，防止终端最后一次查询和前置机撤销之间有延时，导致把用户已支付的交易撤销了。收到支付宝回传的数据必须做验签，个别参数例如fund_bill_list，正确的拼装格式是不解析内部xml节点，直接keyvalue，示例如：...&fund_bill_list=<fund_bill_list><TradeFundBill><amount>0.01</amount><fund_channel>10</fund_channel></TradeFundBill></fund_bill_list>&..业务扩展参数中的门店ID、终端编号ID、Agent_ID必须传入2、收单查询接口(alipay.acquire.query)在调用下单接口之后如果未能立即返回支付成功，则间隔5秒轮询该接口，直到收到用户已付款的状态为止，最长轮询时间建议2分钟3、收单撤销接口(alipay.acquire.cancel)当查询一分钟还未能收到已支付的结果，则调用该接口关闭此订单。撤销接口实现之后也必须让商户要有重试机制，规范是5秒2次，直到该接口能够同步响应结果为止。

流程说明：以上流程需要用到的接口：1、收单退款接口（alipay.acquire.refund）a）退款接口支持全额退款和部分退款。b）退款金额不能超过原始订单的交易总金额。c）退款到用户是原路返回，用户如果使用银行卡快捷，就会直接返回到银行卡，根据银行到账时间T+N。d）如果退款发生失败，并且商户发起的支付宝账号是有余额能够支付退款的，则重试2次退款，还是不行就人工介入，可以联系支付宝服务支持或技术支持解决。流程说明:以上流程需要用到的接口：1、收单撤销接口(alipay.acquire.cancel)a）撤销接口正常调用都是返回成功状态，所以要判断参数是否有资金变动，如果有资金变动则认为是撤销交易成功，无资金变动表示该交易不存在或者已经被关闭了。b）如果返回结果报错，可以重试，如果重试2次还是报错，人工介入，联系支付宝。3集成3.1对账商户如果是直接与支付宝签约，可以由BD开通对账接口，如果是渠道商直接签约的下家，是不能申请对账接口的。3.2开发语言3.3项目排期3.4其他规范1、系统交互模块需要商户做必要的容错，系统一定要健壮，不能因为支付宝改动了任何一个参数就系统奔溃或者影响用户能够正常完成的交易2、必须做灾备机制，有一个备用服务器3、小票必须带有支付宝的交易号或者商户的订单号，必须有优惠金额等信息4、日志：POS端日志：把提交参数xml记下来，考虑日志大小及时清理月服务端日志：记录POS收到的时间和返回时间；当发生错误及异常的情况下，必须对该订单做详细的记录，以便双方技术人员事后排查并解决。5、个性化：查询的轮询