微信公众号支付接口文档
(结算中心-受理机构)
讨论
微信被扫支付接口文档(结算中心-受理机构)V0.0
1
目录
修改日志............................................................................................................................................. 4 1.微信支付简介.................................................................................................................................. 5
1.1.功能简介 ............................................................................................................................... 5 1.2.支付账户 ............................................................................................................................... 5 1.3.支付方式 ............................................................................................................................... 6 2.支付场景介绍.................................................................................................................................. 6
2.1.网页内支付场景---JS API(网页内)支付接口 ................................................................. 6
2.1.1.交互细节 .................................................................................................................... 8 2.1.2.JSAPI 支付时序图 ..................................................................................................... 9 2.1.4.显示微信安全支付标题 ............................................................................................ 9 2.2.线下扫码购买场景---Native(原生)支付接口 .............................................................. 10
2.2.1 使用场景 .................................................................................................................. 10 2.2.2.Native(原生)支付 URL 定义 ............................................................................. 11
3.接口说明........................................................................................................................................ 13
3.1.接口调用规则 ..................................................................................................................... 13 3.2.微信Sign 签名生成方法 .................................................................................................... 14
3.2.1 受理商签名 Sign 生成方法 ................................................................................... 14 3.3 结算中心签名生成方法 ..................................................................................................... 15 3.4 调用流程 ............................................................................................................................. 16 4.API 说明 ........................................................................................................................................ 17
4.1.统一支付接口 ..................................................................................................................... 17 4.2.通用通知接口 ..................................................................................................................... 20
微信被扫支付接口文档(结算中心-受理机构)V0.0
2
4.3.订单查询接口 ..................................................................................................................... 22 4.7 关闭订单接口 ..................................................................................................................... 24 4.8.退款申请接口 ..................................................................................................................... 26 4.9.退款查询接口 ..................................................................................................................... 28 4.10.对账单接口 ....................................................................................................................... 30 4.12.接口调用上报接口 ........................................................................................................... 30 5.企业红包使用说明 ........................................................................................................................ 32
5.1 创建批次企业红包 ............................................................................................................. 32 5.2 提交支付使用企业红包 ..................................................................................................... 32 5.3 查询使用企业红包金额 ..................................................................................................... 33 5.4 企业红包对账单 ................................................................................................................. 33 6. 返回状态码列表 .......................................................................................................................... 33 7.错误码列表.................................................................................................................................... 33 8.常见问题和注意事项 ................................................................................................................... 34
8.1.常见基本概念疑惑 ............................................................................................................. 34 8.2.常见错误现象及解决方法 ................................................................................................. 34 8.3.常见注意事项 ..................................................................................................................... 36
微信被扫支付接口文档(结算中心-受理机构)V0.0
3
修改日志
日期 修改人 创建 修改 修改 修改 修改 操作 修改内容 新增修改日志 修改“4.8 退款申请接口”参数名“Sign_szfs”为“sign_szfs” 修改“3.3 结算中心签名方式” 修改“6 返回状态码列表”,新增状态码“FAIL_STATUS”、“FAIL_SIGN”、“FAIL_SZFS” 修改“4.7 关闭订单接口”参数“商户订单号(out_trade_no)”为必填 2014-12-26 陈恒 2014-12-26 陈恒 2014-12-26 陈恒 2014-12-26 陈恒 2015-01-05 陈恒 微信被扫支付接口文档(结算中心-受理机构)V0.0
4
1.微信支付简介
1.1.功能简介
微信支付,是基于微信客户端提供的支付服务功能。同时向商户提供销售经营分析、账户和资金管理的功能支持。用户通过扫描二维码、微信内打开商品页面购买等多种方式调起 微信支付模块完成支付。
微信支持公众号内支付,即基于公众号向用户收款,公众号相当于收款的商户。其中支付方式,可以分为 JS API(网页内)支付、Native(原生)支付。商户可以结合业务场景, 自主选择支付方式。
本文将全面介绍微信支付的技术方案。
1.2.支付账户
商户向微信提交企业以及银行账户资料,商户功能审核通过后,可以获得以下帐户(包含财付通的商户账户),用于公众号支付。 帐号 appId Mchid SubMchId Key 作用 微信公众号身份的唯一标识。审核通过后,在微信发送的邮件中查看。 商户 ID,身份标识,在微信发送的邮件中查看。 子商户ID,受理模式下子商户与受理商有绑定关系,没有不提交该参数 商户支付密钥Key。登录微信商户后台,进入栏目【账户设置】【密码安全】【API 安全】【API 密钥】 JSAPI 接口中获取 openid,审核后在公众平台开启开发模式后可查看。 Appsecret 微信被扫支付接口文档(结算中心-受理机构)V0.0
5