本章将介绍在开发过程中需要注意的API规则。
机构或商户在收到接口请求返回信息后,需要根据对应字段及判断逻辑来确认该次请求的处理结果。否则会导致请求结果判断错误,引起交易状态同步错误的问题。
微信支付采用回包两层判断的逻辑,分别对应的返回字段为return_code和result_code, return_code代表的是该次请求的通信结果,result_code代表该次请求的业务处理结果。
以Submit Quick Pay API为例:
当return_code和result_code均返回SUCCESS,表示通信成功,业务处理成功,即该笔订单扣款成功;
当return_code返回SUCCESS, result_code返回fail,表示通信成功但业务处理失败。但遇到该情况,机构或商户不能直接判定业务处理失败,因为在某些极端情况下,可能出现返回业务处理失败但实际成功的情况,建议机构或商户在该种情况下轮询查单;
当return_code返回fail,则不会有result_code的返回,该次请求通信失败,可直接判定交易失败。
机构和商户在对接微信支付接口时,都需要遵循以上的判断顺序及逻辑。
注意:查询订单接口除了判断return_code和result_code外,最终的订单状态需要根据trade_state字段来确认。即return_code和result_code均返回SUCCESS也仅代表查询订单业务处理成功,但所查订单的状态需要参考trade_state的返回内容。
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP证