开发指引

更新时间:2023.08.22

# 1. 接口规则

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

# 2. 开发准备

# 2.1. 搭建和配置开发环境

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

测试步骤:

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

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

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

示例代码

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

说明:

  • 上面的开发库为微信支付官方开发库,其它没有审核或者控制下的第三方工具和库,微信支付不保证它们的安全性和可靠性。通过包管理工具引入SDK后,可根据下面每个接口的示例代码替换相关参数后进行快速测试。
  • 开发者如果想详细了解签名生成、签名验证、敏感信息加/解密、媒体文件上传等常用方法的具体代码实现,可阅读下面的详细说明:
  1. 签名生成
  2. 签名验证
  3. 敏感信息加解密
  4. merchantPrivateKey(私钥)
  5. wechatpayCertificates(平台证书)
  6. APIV3Key(V3 key)
  • 如想更详细的了解我们的接口规则,可查看我们的接口规则指引文档

# 3. 快速接入

# 3.1. 业务流程图

流程图

重点步骤说明:

步骤1.1 创建商户违规通知回调地址 ,调服务商、渠道商、从业机构向微信支付设置回调链接。

步骤2.1、3.1、4.1 服务商、渠道商、从业机构向微信支付设置回调链接成功后,当有新的违规、拦截(大于10次时)和申诉事件发生申诉单据状态发生变化时,商户会收到实时同步通知回调。

# 4. 常见问题

# Q:商户平台处置通知什么情况下会通知?

A:商户反馈API每分钟60次,查询投诉单列表 API频率是每分钟200次。