支付接口对接常见问题解答

  • 个别返回码、异常处理方案是什么?
    • 返回码为D01、D07、F01、F02、Q02、Q04、Q07、Q11、S01、S02、S03的交易需要设计一个状态不明的订单状态,可以在交易结果页放置一个查询按钮,点击后发起查询
    • D05表示交易已经成功,当作成功处理就可以了,这个返回码不用当异常处理
    • Q09表示重复请求,业务方自定义处理方式,不处理或者设计一个防止连续点击的机制都可以
    • 其他错误码:根据不同的错误码提示收银员和消费者对应的文案即可(见Excel)
  • 目前没有支付撤销接口?
    • 退款接口即支付撤销也支持退货,调用方不需要区分直接调用即可。
  • 用户发起10元的支付,收银台返回【网络超时】,但实际用户支付成功,如果用户支付成功,商米是否主动发起退款?建议业务方如何处理?
    • 商米不会主动发起退款,业务方可以调用云端的关单接口(正在开发中)关闭订单退回款项,也可以调用查询接口查明订单状态后做对应处理。
  • 支付时,通过广播拿到的支付结果到底有多精准?若是有广播拿到的结果是失败或者超时,但是客户那边已经扣款了,怎么处理此种情况?
  • 正常情况结果广播的到达率和准确率都是100%,除非在接到结果之前设备断电了,业务方可以调用云端的关单接口(正在开发中)关闭订单退回款项,也可以调用查询接口查明订单状态后做对应处理。
  • 为什么没有提供异步的通知结果呢?
    • 已上线,可以询问技术支持索要文档
  • 目前的支付超时是120秒,正常来讲,哪怕用户没事,等120秒也会有些焦躁,那么怎么可以取消当前进行的支付,重新发起支付呢?
    • 商米会提供关单接口(正在开发中)
  • 接口返回错误码Q09请求正在处理中,这种情况,再发起支付是不是无法发起交易了?
    • 需要等到前一笔交易返回,收银台只允许同时进行一笔交易
  • Q09请求正在处理中,这种情况为什么没有流水号
    • 这个只是告知调用方有正在进行的交易,这次请求不算一笔交易
  • 交易失败为什么有的有交易号,有的没有交易号呢?
    • 如果是终端判断失败,请求没有发送到云端,就不会有交易号。
  • 交易金额/实付金额/优惠金额 具体业务定义
    • 交易金额指的是商户当笔交易的收款金额,在调用支付接口时传入
    • 实付金额是指支付通道方在活动期间补贴消费者一定优惠金额后,消费者的实际付款金额,在交易完成由后返回
    • 优惠金额即支付通道在活动期间的补贴金额,在交易完成由后返回