商户签名验签/加解密测试

更新时间:2026.04.08
||

为商户提供签名、验签、加密、解密的测试能力。商户可以选择用平台证书签名,加密,也可以选择微信支付公钥签名,加密。

(1)商户如果使用的是微信支付公钥,请在http请求增加一个Wechatpay-Serial请求头,并传入微信支付公钥ID:"Wechatpay-Serial: PUB_KEY_ID_xxxx"

(2)商户如果使用的是平台证书,请在http请求增加一个Wechatpay-Serial请求头,并传入平台证书序列号:"Wechatpay-Serial: xxxxxxxx"

但是在一次调用中,不支持平台证书和微信支付混合使用,例如使用微信支付公钥签名,平台证书加密。

接口说明

支持商户:【普通服务商】 【平台商户】 【从业机构(银行)】 【从业机构(支付机构)】 【渠道商】 【清算机构】

请求方式:【POST】/v3/security/echo

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


 Content-Type  必填 string

请设置为application/json


 Wechatpay-Serial  必填 string

【微信支付公钥ID】或【微信支付平台证书序列号】  请求参数中的敏感字段,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引;也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


body  包体参数

 notify_url  选填   string

【商户回调地址】 开发者接收请求成功的回调通知的地址,需按照notify_url填写注意事项规范填写。不传入该参数,则不会发起回调通知。


 echo_message  必填   string

【回显信息】 回显信息字段,该字段无需加密。


 encrypted_echo_message  选填   string

【平台证书或微信支付公钥加密测试字段】 平台证书或微信支付公钥加密后的字段。平台证书加密请参考如何使用平台证书加密敏感字段;微信支付公钥加密请参考如何使用微信支付公钥加密敏感字段

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/security/echo \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "notify_url" : "https://www.weixin.qq.com/v3/test",
9    "echo_message" : "hello",
10    "encrypted_echo_message" : "Fx9mh7K5sjqHxxQcgDVhnJ9QdS4nKfcUbuAOjMqetTOozwcJknYJK52SPZSYUCv2bqTTezwVzGPgZ52QL0rTA/ZU7jBY5vqmDj1knBbKIsmNjwtfL0fEAMf5gSzproHq+LBYIoCi91K5tyhp7kKSOxyOz4Hna6Up+IugfZNMbVMxkj7syUs2BOsJFPstvkNwHsJreR2y9cj5jSqtBaXuDK3X3sG1z/yt6mrE04MOEiO/INKdOUYtVfP1yBOazX/tSlXm6ndVswvjSm/61B1kjnNW9TZtPN6FhLqkvS9BVqnGxCYdhGoU2HYh/+pmuaHaO227Ur/D3u2bHux+NKa/qg=="
11  }'
12

应答参数

200 OK

 echo_message  必填   string

【回显信息】 回显信息字段,该字段无需加密。内容与请求消息的echo_message保持一致。


 encrypted_echo_message  选填   string

【商户证书加密回显信息】 回显信息字段,只有请求参数传入了encrypted_echo_message才会返回。使用商户证书私钥解密,解密请参考如何使用API证书解密敏感字段。解密后内容与请求消息的encrypted_echo_message一致。

应答示例

200 OK

1{
2  "echo_message" : "hello",
3  "encrypted_echo_message" : "KYEch8YvVgsfWkl+rZRBkBOxm5k5gh2D4NcOqhCAjbBnb3gqKmZrcNzT7rt0PBL0U8Ix5Pl+BvzbfZobHPtq7+p91fNOy8e/uE1RnGuUj6jl7Ga6RLk3fXvAqAGnvRvCkWqSHnGySGCOze0abIuKOP4b2zZBsXUJT+SRO+Ah9dDabr+quRKDBVqnLUXij1GJlIB0s1+r2oI4pSk7dF7bmGLrjGB6dNyaYjJBs888W8IlMR4wpzoShaCXkhq4o4JwPERY2p1l97NtnzN69ggA9yI4JUdRuzeNc26hKSvPLBds6FKs6BTEu1ZAbj6Vw9QDNvugXNyjKjQwXe4Ddj3E0g=="
4}
5

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

元宝AI
反馈
目录
置顶