扫码支付，使用了微信支付 APIv3接口规则。

开发前需要正确配置 私钥和证书、APIv3密钥。

为了帮助开发者更好的调用接口，我们提供 微信支付APIv3官方SDK (opens new window)，请根据自身开发语言，选择对应的SDK库集成到项目，并在商户平台配置平台证书。

目前微信支付提供JAVA、PHP、GO三种语言版本的SDK，封装了签名生成、签名验证、敏感信息加/解密、媒体文件上传等基础接口功能。

各编程语言的SDK对“扫码支付”的业务接口支持不一样，如若未支持相关业务接口，你可以使用SDK中的HTTP类实现发送HTTP请求，它会自动生成签名和验证签名。

如下通用基础功能接口，已经在SDK中完成封装，可替换相关参数后快速测试。

若使用的编程语言无对应的SDK，则需要按照接口规则与接口详细信息自行开发。

如果开发者使用过PostmanAPI的调试，建议在正式开发之前，使用 Postman签名脚本 (opens new window)进行接口体验。

步骤1.2：客户端调用并呈现金额控件

商户可在微信内网页或小程序中通过金额控件SDK，在页面上呈现“金额控件”。（详见网页展示金额控件、小程序展示金额控件） 在页面上呈现微信支付金额控件，商家通过“展示金额控件”接口，在页面上呈现“金额控件”，通过用户对金额控件的操作，或商家调起金额控件时的设置，由SDK按逻辑自动判断是否出现。（详见下方3.2.1）

步骤1.6：客户端通知商家下单金额

用户输入金额后，轻触“付款”按钮，金额控件SDK向商家传递付款指令（内包含付款金额），并等待商家返回拉起收银台的必要信息。

商家在此过程中获取用户输入金额，并在后台向微信支付下单。

步骤1.8：服务端调用API下单

商户可通过扫码支付下单创建支付订单。（详见下方3.2.2）

步骤 1.12：客户端调起收银台

商户服务端收到下单成功，生成调起支付签名，返回给商户前端，由商户前端调用金额控件SDK，传递签名数据，拉起支付收银台。

步骤2.8：客户端前端回调

用户支付成功后会通过两种渠道为商家发送通知：

商户在没有接收到微信支付结果通知的情况下需要主动调用查询订单API查询支付结果。（详见下方3.2.4）

注意

文档展示了如何使用微信支付服务端 SDK 快速接入扫码支付产品，完成与微信支付对接的部分。

注意

步骤说明：

商户在微信页面或微信小程序通过接口调用来展示微信支付金额控件。

注意

步骤说明：

用户输入金额后，轻触“付款”按钮，金额控件SDK向商家传递付款指令（内包含付款金额），并等待商家返回拉起收银台的必要信息。

示例代码：

重要入参说明：

更多参数、响应详情及错误码请参见扫码支付下单接口文档。

步骤说明：

当用户完成支付，微信会把相关支付结果将通过异步回调的方式通知商户，商户需要接收处理，并按文档规范返回应答。

注意

更多参数、响应详情及错误码请参见 扫码支付支付通知接口文档。

步骤说明：

当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知时，商户可通过查询订单接口核实订单支付状态。

示例代码(通过微信订单号查询)：

注意

更多参数、响应详情及错误码请参见 扫码支付查询订单API接口文档。

步骤说明：

当商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口

示例代码：

注意

更多参数、响应详情及错误码请参见 扫码支付关闭订单接口文档。

最佳实践文档