微信公众号支付接口文档(结算中心-受理机构)v00.docx

微信公众号支付接口文档（结算中心-受理机构）讨论目录修改日志41.微信支付简介51.1.功能简介51.2.支付账户51.3.支付方式62.支付场景介绍62.1.网页内支付场景---JS API（网页内）支付接口62.1.1.交互细节82.1.2.JSAPI 支付时序图92.1.4.显示微信安全支付标题92.2.线下扫码购买场景---Native（原生）支付接口102.2.1 使用场景102.2.2.Native（原生）支付 URL 定义113.接口说明133.1.接口调用规则133.2.微信Sign 签名生成方法143.2.1 受理商签名 Sign 生成方法143.3 结算中心签名生成方法153.4 调用流程164.API 说明174.1.统一支付接口174.2.通用通知接口204.3.订单查询接口224.7 关闭订单接口244.8.退款申请接口264.9.退款查询接口284.10.对账单接口304.12.接口调用上报接口305.企业红包使用说明325.1 创建批次企业红包325.2 提交支付使用企业红包325.3 查询使用企业红包金额335.4 企业红包对账单336. 返回状态码列表337.错误码列表338.常见问题和注意事项348.1.常见基本概念疑惑348.2.常见错误现象及解决方法348.3.常见注意事项35修改日志日期修改人操作修改内容2014-12-26陈恒创建新增修改日志2014-12-26陈恒修改修改“4.8 退款申请接口”参数名“Sign_szfs”为“sign_szfs”2014-12-26陈恒修改修改“3.3 结算中心签名方式”2014-12-26陈恒修改修改“6 返回状态码列表”，新增状态码“FAIL_STATUS”、“FAIL_SIGN”、“FAIL_SZFS”2015-01-05陈恒修改修改“4.7 关闭订单接口”参数“商户订单号（out_trade_no）”为必填1.微信支付简介1.1.功能简介微信支付，是基于微信客户端提供的支付服务功能。同时向商户提供销售经营分析、账户和资金管理的功能支持。用户通过扫描二维码、微信内打开商品页面购买等多种方式调起 微信支付模块完成支付。微信支持公众号内支付，即基于公众号向用户收款，公众号相当于收款的商户。其中支付方式，可以分为 JS API（网页内）支付、Native（原生）支付。商户可以结合业务场景， 自主选择支付方式。本文将全面介绍微信支付的技术方案。1.2.支付账户商户向微信提交企业以及银行账户资料，商户功能审核通过后，可以获得以下帐户（包含财付通的商户账户），用于公众号支付。帐号作用appId微信公众号身份的唯一标识。审核通过后，在微信发送的邮件中查看。Mchid商户 ID，身份标识，在微信发送的邮件中查看。SubMchId子商户ID，受理模式下子商户与受理商有绑定关系，没有不提交该参数Key商户支付密钥Key。登录微信商户后台，进入栏目【账户设置】【密码安全】【API 安全】【API 密钥】AppsecretJSAPI 接口中获取 openid，审核后在公众平台开启开发模式后可查看。注意： 支付密钥 Key 是验证商户唯一性的安全标识，请妥善保管，仅保留在第三方后台和微信后台，不会在网络中传播。1.3.支付方式JS API（网页内）支付：是指用户打开图文消息或者扫描二维码，在微信内置浏览器打开网页进行的支付。商户网页前端通过使用微信提供的 JS API，调用微信支付模块。这种方 式，适合需要在商户网页进行选购下单的购买流程。Native（原生）支付：是指商户组成符合 Native（原生）支付规则的 URL 链接，用户 可通过在会话中点击链接或者扫描对应的二维码直接进入微信支付模块（客户端界面），即可进行支付。这种方式，适合无需选购直接支付的购买流程。跟 JSAPI 最大的区别是不经过网页调起支付。2.支付场景介绍2.1.网页内支付场景---JS API（网页内）支付接口商户已有 H5 商城网站，在微信内打开网页时，可以调用微信支付完成下单购买的流程。 步骤（1）：左图，商户下发图文消息或者通过自定义菜单吸引用户点击进入商户网页。 步骤（2）：右图，进入商家网页，用户选择购买，完成选购流程。步骤（3）：左图，调起微信支付控件，用户开始输入支付密码。步骤（4）：右图，密码验证通过，支付成功。商户后台得到支付成功的通知。步骤（5）：左图，返回商户页面，显示购买成功。该页面由商户自定义。 步骤（6）：右图，公众号下发消息，提示发货成功。该步骤可选。注意：商户也可以把商品网页的链接生成二维码，用户扫一扫打开后即可完成购买支付。2.1.1.交互细节以下是支付场景的交互细节，请认真阅读，并设计商户页面的逻辑：（ 1 ） 用 户 打 开 商 户 网 页 选 购 商 品