开发指引

为了在保证支付安全的前提下，带给商户简单、一致且易用的开发体验，我们推出了全新的微信支付APIv3接口。该版本API的具体规则请参考APIv3接口规则 (opens new window)。

为了帮助开发者调用开放接口，我们提供了JAVA、PHP、GO三种语言版本的开发库，封装了签名生成、签名验证、敏感信息加/解密、媒体文件上传 等基础功能（更多语言版本的开发库将在近期陆续提供）。

测试步骤：

1、根据自身开发语言，选择对应的开发库并构建项目，具体配置请参考下面链接的详细说明：

更多资源可前往微信支付开发者社区 (opens new window)搜索查看。

2、创建加载商户私钥、加载平台证书、初始化httpClient的通用方法。

3、基于接口的示例代码，替换请求参数后可发起测试。

说明：

重点步骤说明：

步骤2 用户确认支付后，商户调用微信支付Native下单API生成预支付交易以获取支付二维码链接code_url；

商户调用Native下单API后，分正常返回和异常返回情况：

步骤4 商户根据返回的code_url生成二维码供用户扫描，有关二维码的规则请参考3.2.2部分的说明。

步骤9-11 商户根据返回的code_url生成二维码供用户扫描，有关二维码的规则请参考3.2.2部分的说明。

本章节展示了如何使用微信支付服务端 SDK 快速接入Native支付产品，完成与微信支付对接的部分。

注意

步骤说明： 用户在商户PC网站内完成商品选择后进入支付页面，商户需要通过后端请求该Native下单API来获取支付二维码链接code_url。

重要入参说明：

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

步骤说明： 通过Native下单API成功获取支付二维码链接（code_url）后，需要在前端（PC网页或POS机具）生成二维码供用户扫描支付。

注意：

例如，weixin：//weixin://pay.weixin.qq.com/bizpayurl/up?pr=NwY5Mz9&groupid=00 生成二维码见下图

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

注意

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

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

注意

需要调用查询接口的情况：

更多参数、响应详情及错误码请参见 微信支付订单号/商户订单号 接口文档。

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

注意

更多参数、响应详情及错误码请参见 关闭订单 (opens new window)通知API接口文档。

步骤说明： 微信支付按天提供交易账单文件，商户可以通过该接口获取账单文件的下载地址。

更多参数、响应详情及错误码请参见 获取交易账单文件下载地址 (opens new window)接口文档。

步骤说明： 过申请交易账单接口获取到账单下载地址（download_url）后，再通过该接口获取到对应的账单文件，文件内包含交易相关的金额、时间、营销等信息，供商户核对订单、退款、银行到账等情况。

注意

更多参数、响应详情及错误码请参见 下载账单 (opens new window)接口文档。

A：微信支付已经不支持通过长按识别二维码的方式或通过相册识别二维码的方式完成支付。

A：微信支付已经不支持通过长按识别二维码的方式或通过相册识别二维码的方式完成支付。