微信公众号支付接口文档(结算中心-受理机构) V0.0
3.4 调用流程
(1)商户发起请求处理流程:
(2)商户调用返回或微信主动通知处理流程:
微信被扫支付接口文档(结算中心-受理机构)V0.0
16
微信公众号支付接口文档(结算中心-受理机构) V0.0
4.API 说明
4.1.统一支付接口
URL 地址:待定
统一支付接口,可接受 JSAPI/NATIVE/APP 下预支付订单,返回预支付订单号。NATIVE 支付返回二维码 code_url。
注意:JSAPI 下单前需要调用登录授权接口(详细调用说明请点击打开链接)获取到用
户的 Openid。
请求参数:
字段名 公众账号 ID 商户号 子商户号 设备号 随机字符串 签名 商品描述 附加数据 商户订单号 变量名 appid mch_id sub_mch_id device_info nonce_str sign body attach out_trade_no 必填 是 是 否 否 是 是 是 否 是 类型 String(32) String(32) String(32) String(32) String(32) String(32) String(127) String(127) String(32) 说明 微信分配的公众账号 ID 微信支付分配的商户号 微信支付分配的子商户号, 受理模式下必填 微信支付分配的终端设备号 随机字符串,不长于 32 位 签名,详细签名方法见 3.2 节 商品描述 附加数据,原样返回 商 户 系统 内 部 的 订单 号 ,32个字符内、可包含字母,确保 在商户系 统唯一,详细说明 见 8.3节第四项 订单总金额,单位为分,不 能带小数点 订单生成的机器 IP 订 单 生 成 时 间 , 格 式 为 yyyyMMddHHmmss,如 2009 年 12 月 25 日 9 点 10 分 10 秒表 示为 20091225091010。时区 总金额 终端 IP 交易起始时间 total_fee spbill_create_ip time_start 是 是 否 Int String(16) String(14) 微信被扫支付接口文档(结算中心-受理机构)V0.0
17
交易结束时间 time_expire 微信公众号支付接口文档(结算中心-受理机构) V0.0
String(14) 否 为 GMT+8 beijing。该时间取 自商户服务器订 单 失 效 时 间 , 格 式 为 yyyyMMddHHmmss,如 2009 年 12 月 27 日 9 点 10 分 10 秒表 示为 20091227091010。时区 为 GMT+8 beijing。该时间取 自商户服务器 商品标记 goods_tag 否 String(32) 商品标记,该字段不能随便 填,不使用请填空,使用说 明详见第 5 节 接收微信支付成功通知 JSAPI、NATIVE、APP 用户在商户 appid 下的唯一 标识,trade_type 为 JSAPI 时,此参数必传,获取方式 见表头说明。 只 在 trade_type 为 NATIVE 时需要填写。此 id 为二维码 中包含的商品 ID,商户自行 维护。 通知地址 交易类型 用户标识 notify_url trade_type openid 是 是 否 String(256) String(16) String(128) 商品 ID
product_id 否 String(32) 返回参数: 字段名 返回状态码 变量名 return_code 必填 是 类型 String(16) 说明 此字段是通信标识,非交易标 识 , 交 易 是 否 成 功 需 要 查 看 result_code 来判断 详见 第 6 节 返回信息,如非空,为错误 原因 签名失败 参数格式校验错误 微信侧超时 返回信息 return_msg 否 String(128) 以下字段在 return_code 为 SUCCESS 的时候有返回 公众账号 ID appid 是 String(32) 微信分配的公众账号 ID 微信被扫支付接口文档(结算中心-受理机构)V0.0
18
商户号 子商户号 设备号 随机字符串 签名 业务结果 错误代码 错误代码描述 交易类型 预支付 ID 二维码链接 mch_id sub_mch_id device_info nonce_str sign result_code err_code err_code_des trade_type prepay_id code_url 微信公众号支付接口文档(结算中心-受理机构) V0.0
是 否 否 是 是 是 否 否 是 是 否 String(32) String(32) String(32) String(32) String(32) String(16) String(32) String(128) String(16) String(64) String(64) 微信支付分配的商户号 微信支付分配的子商户号, 受理模式下必填 微 信 支 付 分 配 的 终 端 设 备 号, 随机字符串,不长于32 位 签名,详细签名方法见 3.2 节 SUCCESS/FAIL 列表第7 节 结果信息描述 JSAPI、NATIVE、APP 微信生成的预支付 ID,用于 后续接口调用中使用 trade_type 为 NATIVE 是 有 返回,此参数可直接生成二 维码展示出来进行扫码支付 以下字段在 return_code 和 result_code 都为 SUCCESS 的时候有返回 请求示例:
wxd00000000000000f NATIVE
返回示例:
wx2421b1c4370ec43b
微信被扫支付接口文档(结算中心-受理机构)V0.0
19
微信公众号支付接口文档(结算中心-受理机构) V0.0
4.2.通用通知接口
通知 URL 是 4.1 节中提交的参数 notify_url,支付完成后,结算中心会把相关支付和用户信息发送到该 URL,第三方受理机构需接收该通知并验签,验签通过才可做下一步操作。
对后台通知交互时,如果结算中心收到第三方受理机构的应答不是成功或超时,结算中心认为通知失败,中心会通过一定的策略(如 30 分钟共 8 次)定期重新发起通知,尽可能提高通知的成功率, 但中心不保证通知最终能成功。
由于存在重新发送后台通知的情况,因此同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。
推荐的做法是,当收到通知进行处理时,首先检查对应业务数据的状态,判断该通知是 否已经处理过,如果没有处理过再进行处理,如果处理过直接返回结果成功。在对业务数据 进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。
通知参数:
字段名 返回状态码 变量名 return_code 必填 是 类型 说明 返回信息 return_msg 否 String(16) 此字段是通信标识,非交易标 识 , 交 易 是 否 成 功 需 要 查 看 result_code 来判断 详见 第 6 节 String(128) 返回信息,如非空,为错误 原因 签名失败 参数格式校验错误 以下字段在 return_code 为 SUCCESS 的时候有返回 公众账号 ID appid 是 String(32) 微信分配的公众账号 ID 微信被扫支付接口文档(结算中心-受理机构)V0.0
20