开发指引

更新时间:2025.09.16

在订阅某个消息主题后,当商户发生该主题下的业务变更时,微信支付会向预填写的服务器地址发送消息。

接收订阅消息

以「商户新增管控流水通知」为例,该主题的消息结构见:点击查看消息结构详情

当商户新增一条管控流水时,服务商将收到如下消息示例

1{
2    "id": "d1dbc742-f4a4-1111-9318-55e8a8bc4d20",
3    "create_time": "2024-06-19T15:22:17+08:00",
4    "resource_type": "encrypt-resource",
5    "event_type": "MERCHANT_NOTIFY.NOTIFY",
6    "summary": "订阅消息",
7    "resource": {
8        "original_type": "merchant_notify",
9        "algorithm": "AEAD_AES_256_GCM",
10        "ciphertext": "fiBrsqllJFsZy8110iJFzwlFPqHoWH/BQXpiSUTsiQZuiajEKqMXj5Yzqve5t4RCKIVupt/ILfyNRJkGwS9WbTc+OkfYrY+PQlcI25P0kKn0/bc+EKV9OK12NOVesOpjtU7RRMudjs1v+vp70Gr8mzubQ087plsee1x0hH84Qid+i1nyXfxaDpkDUJefHfRnBohosYjN6H7IrudENBt0ZQtAQTz0m8BqM29S6+YJRy0AUCBfQk27+xy3rxby5zZ5/rsjAp/Si7sSjk0BQw8/AfwU70e6FyLrU0u6f+nEisioaeePKayMmoDBA+4j/pFzvyFdp5JDcqbzX5u/35prIUrIzrtsnHsnZLAa0bf8fpSthkC6EQ8=",
11        "associated_data": "merchant_notify",
12        "nonce": "zeBlNx7MOy8s"
13    }
14}

解密后的消息内容如下

1{
2    "message_content": {
3        "merchant_code": "00000000000", 
4        "merchant_company_name": "测试商户号", 
5        "business_time": "2024-06-19T15:22:17+08:00", 
6        "business_code": "空", 
7        "business_state": "TEST"
8    }, 
9    "topic_name": {
10        "topic_english_name": "test", 
11        "topic_chinese_name": "测试消息"
12    }
13}

解密流程可参考:如何解密证书和回调报文

详情可参考:支付通知

进行后续处理

以「商户新增管控流水通知」为例,合作伙伴在接收到消息后,可通过 「特约商户管控状态查询接口」来进一步定位商户遇到的具体问题,该接口资料如下:

指引文档:商户被管控能力及原因查询

API 文档:查询子商户管控情况

元宝AI
反馈
目录
置顶