小程序接入微信支付V3接口实战指南

小程序接入微信支付V3接口实战指南

引言

随着微信小程序的广泛应用，支付功能成为其不可或缺的一部分。微信支付V3接口提供了更为安全、高效的支付解决方案。本文将详细介绍小程序如何接入微信支付V3接口，帮助开发者轻松实现支付功能。

一、注册与准备

1. 注册微信商户号

首先，你需要在微信支付官网注册成为商户。通过上传企业信息、法人信息等资料，完成商户注册流程。成功注册后，你将获得商户号（mchid），这是接入微信支付的重要凭证。

2. 开通小程序支付业务

在微信商户平台中，进入“产品中心”，选择“我的产品”，找到“JSAPI支付”并开通。开通后，你将能够使用微信支付V3接口为小程序提供支付服务。

3. 获取必要接入参数

在商户平台中，你需要获取以下必要的接入参数：

• Certificate：商户API证书，用于API请求的身份验证。
• PrivateKey：商户私钥，用于签名和加密。
• merchantId：商户号，用于标识商户身份。
• SerialNumbe：商户证书序列号，用于证书管理。
• apiV3Key：APIv3密钥，用于请求加密和解密。

二、配置小程序

1. 关联小程序

在微信商户平台的“产品中心”中，选择“APPID授权管理”，新增授权申请单，输入小程序的APPID进行关联。关联成功后，你将在小程序管理后台看到已关联的商户号。

2. 设置支付信息

在小程序管理后台，进入“微信支付-商户号管理”，找到已关联的商户号，并设置支付信息，包括APIv3密钥等。

三、开发步骤

1. 引入微信支付SDK

在你的小程序或后端服务中，引入微信支付官方的SDK。以Java为例，可以在Maven或Gradle中添加依赖：

<!-- Maven依赖 -->
<dependency>
    <groupId>com.github.wechatpay-apiv3</groupId>
    <artifactId>wechatpay-apache-httpclient</artifactId>
    <version>最新版本</version>
</dependency>

// Gradle依赖
implementation 'com.github.wechatpay-apiv3:wechatpay-java:最新版本'

2. 初始化微信支付配置

在你的项目中，配置微信支付的相关参数，包括商户号、私钥、API密钥等。可以使用配置文件或环境变量来管理这些敏感信息。

3. 发起支付请求

当用户在小程序中发起支付请求时，你的后端服务需要调用微信支付的API创建支付订单。以下是使用Java发送支付请求的一个示例代码片段：

// 省略部分代码，仅展示关键部分
WechatPayHttpClientBuilder builder = WechatPayHttpClientBuilder.create();
builder.withMerchant(merchantId, merchantSerialNumber, privateKey);
// ... 其他配置
CloseableHttpClient httpClient = builder.build();
HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/pay/transactions/jsapi");
// 设置请求头、请求体等
// ... 发送请求并处理响应

4. 小程序端调用支付API

在你的小程序中，使用wx.requestPayment API调起支付界面。你需要将后端服务返回的支付参数（如prepay_id等）传递给该API。

wx.requestPayment({
  timeStamp: '', // 时间戳
  nonceStr: '', // 随机字符串
  package: '', // 预支付会话标识，格式如prepay_id=***
  signType: 'RSA', // 签名方式
  paySign: '', // 签名
  success (res) {
    // 支付成功后的回调函数
  },
  fail (err) {
    // 支付失败后的回调函数
  }
})

5. 接收支付结果通知

微信支付成功后，微信服务器会向你的服务器发送支付结果通知。你需要设置支付通知的回调地址，并在该地址