---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4012081606.md"
title: "APIv3概述"
doc_id: 4012081606
---

>更新时间：2024.11.21

## 关于 APIv3

为了在保证支付安全的前提下，带给商户简单、一致且易用的开发体验，我们推出了全新的微信支付 APIv3。

相较于之前的微信支付API，主要区别是：

- 遵循统一的REST的设计风格

- 使用JSON作为数据交互的格式，不再使用XML

- 使用基于非对称密钥的SHA256-RSA的数字签名算法，不再使用MD5或HMAC-SHA256

- 签名需要使用商户API证书进行签名具体可参考[申请商户API证书](https://pay.weixin.qq.com/doc/v3/merchant/4012072428.md)

- 验签支持2种方式：

  - 微信支付公钥模式（推荐使用）：商户在验证微信支付API应答和回调通知的签名时需要用到微信支付公钥，且商户可以按需更新微信支付公钥，具体操作可参考：[如何使用微信支付公钥验签](https://pay.weixin.qq.com/doc/v3/merchant/4013053249.md)。

  - 平台证书模式：商户在验证微信支付API应答和回调通知的签名时需要用到平台证书，平台证书的有效期为5年，商户需每5年更新一次，对系统实现要求较高，推荐使用微信支付公钥模式。
- 使用AES-256-GCM，对回调中的关键信息进行加密保护


## 如何接入APIv3

我们建议商户基于微信支付官方提供的微信支付工具库[Java](https://pay.weixin.qq.com/doc/v3/merchant/4014931831.md)/[Go](https://pay.weixin.qq.com/doc/v3/merchant/4015119334.md)来接入APIv3，该工具库已封装 JSON处理、密钥加载、加密签名、请求头构建、响应验证等能力，降低开发复杂度。具体用法请参考各API接口文档中的请求示例。

此外，我们也提供APIv3的[Postman调试工具](https://pay.weixin.qq.com/doc/v3/merchant/4012076519.md)、微信支付[平台证书下载工具](https://pay.weixin.qq.com/doc/v3/merchant/4012076524.md)，你可以通过我们的[GitHub](https://github.com/wechatpay-apiv3)获取它们的源代码和最新版本信息。

## 联系我们

如果你有任何问题，欢迎访问我们的[开发者社区](https://developers.weixin.qq.com/community/pay)。