使用 PHP SDK 快速开始

更新时间：2023.08.17

在本教程中，你将简要了解微信支付的 PHP SDK。在学习过程中，你将

掌握如何安装 PHP SDK
了解请求微信支付需要哪些密钥和证书
了解如何使用 PHP SDK 请求微信支付

# 环境要求

Guzzle 7.0，PHP >= 7.2.5。
Guzzle 6.5，PHP >= 7.1.2

我们推荐使用目前处于 Active Support (opens new window) 阶段的 PHP 8 和 Guzzle 7。

# 安装

使用 Composer (opens new window) 安装最新版本的 SDK：

1composer require wechatpay/wechatpay

你可以在 GitHub 找到 PHP SDK (opens new window) 的源代码、使用说明和最新版本信息。

# 必需的证书和密钥

运行 SDK 必需以下的证书和密钥：

由于 PHP-FPM (opens new window) 进程模型限制，PHP SDK 不支持自动获取和更新微信支付平台证书。你可以使用 SDK 自带的工具 (opens new window)下载微信支付平台证书。

1composer exec CertificateDownloader.php -- -k ${apiV3key} -m ${mchId} -f ${mchPrivateKeyFilePath} -s ${mchSerialNo} -o ${outputFilePath}

# 发起请求

以 Native 支付为例，向微信支付发起你的第一个请求。

1<?php
2
3require_once('vendor/autoload.php');
4
5use WeChatPay\Builder;
6use WeChatPay\Crypto\Rsa;
7use WeChatPay\Util\PemUtil;
8
9// 设置参数
10
11// 商户号
12$merchantId = '190000****';
13
14// 从本地文件中加载「商户API私钥」，「商户API私钥」会用来生成请求的签名
15$merchantPrivateKeyFilePath = 'file:///path/to/merchant/apiclient_key.pem';
16$merchantPrivateKeyInstance = Rsa::from($merchantPrivateKeyFilePath, Rsa::KEY_TYPE_PRIVATE);
17
18// 「商户API证书」的「证书序列号」
19$merchantCertificateSerial = '3775B6A45ACD588826D15E583A95F5DD********';
20
21// 从本地文件中加载「微信支付平台证书」(可使用证书下载工具得到），用来验证微信支付应答的签名
22$platformCertificateFilePath = 'file:///path/to/wechatpay/cert.pem';
23$platformPublicKeyInstance = Rsa::from($platformCertificateFilePath, Rsa::KEY_TYPE_PUBLIC);
24
25// 从「微信支付平台证书」中获取「证书序列号」
26$platformCertificateSerial = PemUtil::parseCertificateSerialNo($platformCertificateFilePath);
27
28// 构造一个 APIv3 客户端实例
29$instance = Builder::factory([
30    'mchid'      => $merchantId,
31    'serial'     => $merchantCertificateSerial,
32    'privateKey' => $merchantPrivateKeyInstance,
33    'certs'      => [
34        $platformCertificateSerial => $platformPublicKeyInstance,
35    ],
36]);
37
38// 以 Native 支付为例，发送请求
39$resp = $instance
40    ->chain('v3/pay/transactions/native')
41    ->post(['json' => [
42        'mchid'        => '1900006XXX',
43        'out_trade_no' => 'native12177525012014070332333',
44        'appid'        => 'wxdace645e0bc2cXXX',
45        'description'  => 'Image形象店-深圳腾大-QQ公仔',
46        'notify_url'   => 'https://weixin.qq.com/',
47        'amount'       => [
48            'total'    => 1,
49            'currency' => 'CNY'
50        ],
51    ]]);
52echo $resp->getBody(), PHP_EOL;

# 联系 SDK 团队获取帮助

# 接下来阅读

通过这个快速介绍，你已经安装了 PHP SDK 并学习了一些基础知识。接下来，你可以阅读具体的产品文档，学习如何接入微信支付。

文档是否有帮助

更多支持

开发者社区微信开放平台微信公众平台腾讯客服

使用 PHP SDK 快速开始

# 环境要求

# 安装

# 必需的证书和密钥

# 发起请求

# 联系 SDK 团队获取帮助

# 接下来阅读

关于我们

服务支持

友情链接

客服帮助