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

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

测试步骤：

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

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

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

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

说明：

App接入微信支付，需要先将商户App在微信开放平台进行注册，登记App开发参数以生成AppID。具体操作步骤如下：

登录微信开放平台 (opens new window)，进入【管理中心 → 移动应用 → 创建移动应用】；

完成基本信息的录入，商户需要在本步骤提交App对应的下载地址，应用官网，应用水印，icon等业务信息；

完成平台信息的录入，商户需要在本步骤提交App在Android及iOS端对应的开发参数，包括Android端应用的包名，应用签名，iOS端应用的bundle ID, universal link等；

以上信息全部提交完成后，即完成App的注册，商户可在【管理中心 → 移动应用】中，选择具体的应用查看其AppID及已获得的接口能力；

获取到App的AppID后，需要将该AppID与商户的收款mch_id进行绑定，商户可登录商户平台后前往【产品中心 -> AppID账号管理】界面中进行AppID的绑定及管理，界面如图所示：

由于苹果公司在iOS13系统回收了查询 App bundleID 的能力，导致微信无法保证授权凭证能正确返回给AppID对应的应用。为此，微信支付强烈要求所有商户尽快升级到OpenSDK1.8.6，并让用户及时更新App，否则安全风险将一直存在。谢谢配合！

详细OpenSDK升级指引请参见：OpenSDK升级指引 (opens new window)

注意

OpenSDK升级后请一定按照文档要求完成验证工作，确保OpenSDK升级成功。

以下项目开发环境以Xcode6.0，运行环境为IOS7.0为例，说明其开发中需要的操作

商户在微信开放平台申请开发App应用后，微信开放平台会生成App的唯一标识AppID。在Xcode中打开项目，设置项目属性中的URL Schemes为您的AppID。如图标红位置所示

商户App工程中引入微信lib库和头文件，调用API前，需要先向微信注册您的AppID，代码如下：

[WXApi registerApp：@"wxd930ea5d5a258f4f" withDescription：@"demo 2.0"];

注意

OpenSDK前端拉起支付及SDK回调的相关说明，请参考OpenSDK调起支付说明 (opens new window)

商户在微信开放平台申请开发应用后，微信开放平台会生成App的唯一标识AppID。由于需要保证支付安全，需要在开放平台绑定商户应用包名和应用签名，设置好后才能正常发起支付。设置界面在【开放平台】中的栏目【管理中心 / 修改应用 / 修改开发信息】里面，如图红框内所示。

应用包名：是在App项目配置文件AndroidManifest.xml中声明的package值，例如上图中的package="demo.wxpay.tenpay.com"。

应用签名：根据项目的应用包名和编译使用的keystore，可由签名工具生成一个32位的md5串，在调试的手机上安装签名工具后，运行可生成应用签名串，如图8.9所示，绿色串即应用签名。

点击下载签名生成工具 (opens new window)

商户App工程中引入微信JAR包，调用API前，需要先向微信注册您的AppID，代码如下：

注意

OpenSDK前端拉起支付及SDK回调的相关说明，请参考OpenSDK调起支付说明 (opens new window)

重点步骤说明：

步骤3： 用户下单发起支付，商户可通过微信支付App下单API创建支付订单。

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

步骤8： 商户通过App调起支付OpenSDK调起微信支付，发起支付请求，有关OpenSDK调起支付的详细说明，请参考iOS开发要点说明的说明

步骤15-19: 用户支付成功后，商户可通过以下两种方式获取订单状态。

我们通过以下接口将用户确认订单信息回调通知给商户系统：

方法一： 支付结果通知。用户支付成功后，微信支付会将支付成功的结果以回调通知的形式同步给商户，商户的回调地址需要在调用App下单API时传入notify_url参数。

方法二： 当因网络抖动或本身notify_url存在问题等原因，导致无法接收到回调通知时，商户也可主动调用查询订单API 查询订单API来获取订单状态。

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

注意

步骤说明：用户在商户App内完成商户选择后进入支付页面，商户需要通过后端请求该App下单API来获取预支付ID。

重要入参说明：

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

步骤说明： 通过App下单API成功获取 预支付交易会话标识（prepay_id） 后，需要通过OpenSDK来调起微信支付收银台

重要入参说明：

paySign生成规则、响应详情及错误码请参见App调起支付接口文档。

商户服务器生成支付订单，先调用App下单API生成预付单，获取到prepay_id后将参数再次签名传输给App发起支付。以下是调起微信支付的关键代码：

注意

该sign生成字段名列表见调起支付API。

按照微信SDK Sample，在类实现onResp函数，支付完成后，微信App会返回到商户App并回调onResp函数，开发者需要在该函数中接收通知，判断返回错误码。如果支付成功则去后台查询支付结果再展示用户实际支付结果。注意一定不能以客户端返回作为用户支付的结果，应以服务器端接收的支付通知或查询API返回的结果为准。

代码示例如下：

回调中errCode值列表：

商户服务器生成支付订单，先调用App下单API生成预付单，获取到prepay_id后将参数再次签名传输给App发起支付。以下是调起微信支付的关键代码：

注意

该sign生成字段名列表见调起支付API。

参照微信SDK Sample，在net.sourceforge.simcpux.wxapi包路径中实现WXPayEntryActivity类(包名或类名不一致会造成无法回调)，在WXPayEntryActivity类中实现onResp函数，支付完成后，微信App会返回到商户App并回调onResp函数，开发者需要在该函数中接收通知，判断返回错误码。 如果支付成功则去后台查询支付结果再展示用户实际支付结果。注意一定不能以客户端返回作为用户支付的结果，应以服务器端的接收的支付通知或查询API返回的结果为准。

代码示例如下：

回调中errCode值列表：

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

注意

特别提醒： 商户系统对于开启结果通知的内容一定要做签名验证，并校验通知的信息是否与商户侧的信息一致，防止数据泄露导致出现“假通知”，造成资金损失。

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

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

注意

查询订单可通过微信支付订单号和商户订单号两种方式查询，两种查询方式返回结果相同

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

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

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

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

注意

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

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

更多参数、响应详情及错误码请参见 申请交易账单支付通知API接口文档

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

注意

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

A：请按以下几点进行排查：

查看App下单参数返回是否正常，是否有正确的在调用SDK前获取了正确的prepay_id；

查看调用SDK签名是否正确，请注意以下几点：

检查客户端调用sendReq（PayReq）对象赋值的正确性（必要时让商户提供数据），若通过异步获取到后台数据，比如data对象是通过异步请求得到的对象：request.AppID = data.AppID; 实际AppID属性值为空；

检查对应的开发配置，包括iOS的AppID配置，Android的包名及包签名设置。

A：请确认唤起支付参数字段名是否与文档的一致。

A：App支付需要进行单独的授权开通才可使用，请前往服务商平台子商户管理中找到对应的子商户授权服务商App支付权限。

A：在调用App下单接口前，需保证子商户号与子商户App的AppID存在绑定关系，请服务商前往服务商平台的子商户管理页面中操作绑定。