PHPackages                             ethenoscar2011/pt-wechatpay-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. ethenoscar2011/pt-wechatpay-php

ActiveLibrary[Payment Processing](/categories/payments)

ethenoscar2011/pt-wechatpay-php
===============================

\[A\]Sync Chainable WeChatPay v2&v3's OpenAPI SDK for PHP - Compatible with PHP 5.6+

0.0.1(9mo ago)08Apache-2.0PHPPHP >=5.6.0

Since Sep 11Pushed 9mo agoCompare

[ Source](https://github.com/ethenoscar2011/pt-wechatpay-php)[ Packagist](https://packagist.org/packages/ethenoscar2011/pt-wechatpay-php)[ Docs](https://pay.weixin.qq.com/)[ RSS](/packages/ethenoscar2011-pt-wechatpay-php/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (4)Versions (2)Used By (0)

微信支付 WeChatPay OpenAPI SDK (PHP 5.6+ 兼容版)
=========================================

[](#微信支付-wechatpay-openapi-sdk-php-56-兼容版)

\[A\]Sync Chainable WeChatPay v2&v3's OpenAPI SDK for PHP - 兼容 PHP 5.6+

[![Packagist Stars](https://camo.githubusercontent.com/ad722157f600aaee1260efc1feee23774316921fc4ad50882c683bf34ef0985f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f73746172732f70742f7765636861747061792d706870)](https://packagist.org/packages/pt/wechatpay-php)[![Packagist Downloads](https://camo.githubusercontent.com/17889073298832a8461b3911c295dd20d1a8182e2aea00d7e6c4d130d983ada7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f70742f7765636861747061792d706870)](https://packagist.org/packages/pt/wechatpay-php)[![Packagist Version](https://camo.githubusercontent.com/913dd44a2ef0254d8bbc09b005c26ee8b57aefb1b5669c86907006e8280f09e5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70742f7765636861747061792d706870)](https://packagist.org/packages/pt/wechatpay-php)[![Packagist PHP Version Support](https://camo.githubusercontent.com/9a229b49770af55e116fe86c1d5a50ec8682843453bea0ac01d47209745806d0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f70742f7765636861747061792d706870)](https://packagist.org/packages/pt/wechatpay-php)[![Packagist License](https://camo.githubusercontent.com/7d9a4836c6c5197c7640b38bd885b01ad10d648e9104c99453db17cd95d0106b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c6963656e73652f70742f7765636861747061792d706870)](https://packagist.org/packages/pt/wechatpay-php)

概览
--

[](#概览)

基于 [Guzzle HTTP Client](http://docs.guzzlephp.org/) 的微信支付 PHP 开发库，兼容 PHP 5.6+ 版本。

### 功能介绍

[](#功能介绍)

1. 微信支付 APIv2 和 APIv3 的 Guzzle HTTP 客户端，支持 [同步](#%E5%90%8C%E6%AD%A5%E8%AF%B7%E6%B1%82) 或 [异步](#%E5%BC%82%E6%AD%A5%E8%AF%B7%E6%B1%82) 发送请求，并自动进行请求签名和应答验签
2. [链式实现的 URI Template](#%E9%93%BE%E5%BC%8F-uri-template)
3. [敏感信息加解密](#%E6%95%8F%E6%84%9F%E4%BF%A1%E6%81%AF%E5%8A%A0%E8%A7%A3%E5%AF%86)
4. [回调通知](#%E5%9B%9E%E8%B0%83%E9%80%9A%E7%9F%A5)的验签和解密

项目状态
----

[](#项目状态)

当前版本为 `1.4.12` 版，基于官方 wechatpay-php 重构，兼容 PHP 5.6+ 版本。 项目版本遵循 [语义化版本号](https://semver.org/lang/zh-CN/)。

环境要求
----

[](#环境要求)

项目支持的环境如下：

- PHP >= 5.6.0
- Guzzle 6.0+ 或 7.0+
- ext-curl, ext-libxml, ext-simplexml, ext-openssl

我们推荐使用目前处于 [Active Support](https://www.php.net/supported-versions.php) 阶段的 PHP 8 和 Guzzle 7。

安装
--

[](#安装)

推荐使用 PHP 包管理工具 [Composer](https://getcomposer.org/) 安装 SDK：

```
composer require ethenoscar2011/pt-wechatpay-php
```

开始
--

[](#开始)

ℹ️ 以下是 [微信支付 API v3](https://pay.weixin.qq.com/docs/merchant/development/interface-rules/introduction.html) 的指引。如果你是 API v2 的使用者，请看 [README\_APIv2](README_APIv2.md)。

### 概念

[](#概念)

- **商户 API 证书**，是用来证实商户身份的。证书中包含商户号、证书序列号、证书有效期等信息，由证书授权机构（Certificate Authority ，简称 CA）签发，以防证书被伪造或篡改。详情见 [什么是商户API证书？如何获取商户API证书？](https://kf.qq.com/faq/161222NneAJf161222U7fARv.html) 。
- **商户 API 私钥**。你申请商户 API 证书时，会生成商户私钥，并保存在本地证书文件夹的文件 apiclient\_key.pem 中。为了证明 API 请求是由你发送的，你应使用商户 API 私钥对请求进行签名。

    > 🔑 不要把私钥文件暴露在公共场合，如上传到 Github，写在 App 代码中等。
- **微信支付平台证书**。微信支付平台证书是指：由微信支付负责申请，包含微信支付平台标识、公钥信息的证书。你需使用微信支付平台证书中的公钥验证 API 应答和回调通知的签名。

    > 🔖 通用的 composer 命令，像安装依赖包一样 [下载平台证书](#%E5%A6%82%E4%BD%95%E4%B8%8B%E8%BD%BD%E5%B9%B3%E5%8F%B0%E8%AF%81%E4%B9%A6) 文件，供SDK初始化使用。
- **证书序列号**。每个证书都有一个由 CA 颁发的唯一编号，即证书序列号。
- **微信支付公钥**，用于应答及回调通知的数据签名，可在 [微信支付商户平台](https://pay.weixin.qq.com) -> 账户中心 -> API安全 直接下载。
- **微信支付公钥ID**，是微信支付公钥的唯一标识，可在 [微信支付商户平台](https://pay.weixin.qq.com) -> 账户中心 -> API安全 直接查看。

### 初始化一个APIv3客户端

[](#初始化一个apiv3客户端)

```