守约状态变化通知(JSON)
用户守约状态发生变更后，微信会把用户守约状态信息通知给商户。 官方文档
请求头(headers)
Wechatpay-Nonce: 3d980fb850fdce97f6bfb3d248597f16
Wechatpay-Serial: 7132d72a03e93cddf8c03bbd1f37eedf********
Wechatpay-Signature: i48r5y8IQw1qpTO+ywoV...
Wechatpay-Signature-Type: WECHATPAY2-SHA256-RSA2048
Wechatpay-Timestamp: 1710048759
Request-ID: 08F78BB5AF0610D302189F99DD5C20BA56F89845-0请求报文(body)
json
{
"id":"EV-2018022511223320873",
"create_time":"2015-05-20T13:29:35+08:00",
"resource_type":"encrypt-resource",
"event_type":"DISCOUNT_CARD.AGREEMENT_ENDED",
"resource" : {
"algorithm":"AEAD_AES_256_GCM",
"ciphertext": "...",
"nonce": "...",
"associated_data": ""
}
}resource.ciphertext 解密后的明文格式
json
{
"appid": "wxd678efh567hg6787",
"card_id": "233bcbf407e87789b8e471f251774f95",
"card_template_id": "87789b2f25177433bcbf407e8e471f95",
"create_time": "2015-05-20T13:29:35.12+08:00",
"mchid": "1230000109",
"objectives": [
{
"count": 1,
"description": "特价商品",
"name": "一周购买三次商品",
"objective_completion_records": [
{
"completion_count": 1,
"completion_time": "2015-05-20T13:29:35.120+08:00",
"completion_type": "INCREASE",
"description": "购买商品/取消购买商品",
"objective_completion_serial_no": "578354545",
"objective_id": "123456",
"remark": "特价商品"
},
{
"completion_count": 1,
"completion_time": "2015-05-20T13:29:35.120+08:00",
"completion_type": "INCREASE",
"description": "购买商品/取消购买商品",
"objective_completion_serial_no": "578354545",
"objective_id": "123456",
"remark": "特价商品"
}
],
"objective_id": "123456",
"unit": "次"
},
{
"count": 1,
"description": "特价商品",
"name": "一周购买三次商品",
"objective_completion_records": [
{
"completion_count": 1,
"completion_time": "2015-05-20T13:29:35.120+08:00",
"completion_type": "INCREASE",
"description": "购买商品/取消购买商品",
"objective_completion_serial_no": "578354545",
"objective_id": "123456",
"remark": "特价商品"
},
{
"completion_count": 1,
"completion_time": "2015-05-20T13:29:35.120+08:00",
"completion_type": "INCREASE",
"description": "购买商品/取消购买商品",
"objective_completion_serial_no": "578354545",
"objective_id": "123456",
"remark": "特价商品"
}
],
"objective_id": "123456",
"unit": "次"
}
],
"openid": "oUpF8uMuAJ2pxb1Q9zNjWeS6o",
"out_card_code": "6e8369071cd942c0476613f9d1ce9ca3",
"rewards": [
{
"amount": 100,
"count": 1,
"count_type": "COUNT_LIMIT",
"description": "特价商品优惠",
"name": "八折优惠",
"reward_id": "123456",
"reward_usage_records": [
{
"amount": 1,
"description": "购买商品",
"remark": "特价商品",
"reward_id": "123456",
"reward_usage_serial_no": "578354",
"usage_count": 100,
"usage_time": "2015-05-20T13:29:35.120+08:00",
"usage_type": "INCREASE"
},
{
"amount": 1,
"description": "购买商品",
"remark": "特价商品",
"reward_id": "123456",
"reward_usage_serial_no": "578354",
"usage_count": 100,
"usage_time": "2015-05-20T13:29:35.120+08:00",
"usage_type": "INCREASE"
}
],
"unit": "个"
},
{
"amount": 100,
"count": 1,
"count_type": "COUNT_LIMIT",
"description": "特价商品优惠",
"name": "八折优惠",
"reward_id": "123456",
"reward_usage_records": [
{
"amount": 1,
"description": "购买商品",
"remark": "特价商品",
"reward_id": "123456",
"reward_usage_serial_no": "578354",
"usage_count": 100,
"usage_time": "2015-05-20T13:29:35.120+08:00",
"usage_type": "INCREASE"
},
{
"amount": 1,
"description": "购买商品",
"remark": "特价商品",
"reward_id": "123456",
"reward_usage_serial_no": "578354",
"usage_count": 100,
"usage_time": "2015-05-20T13:29:35.120+08:00",
"usage_type": "INCREASE"
}
],
"unit": "个"
}
],
"state": "ONGOING",
"time_range": {
"begin_time": "2015-05-20T13:29:35.12+08:00",
"end_time": "2015-05-20T13:29:35.12+08:00"
},
"total_amount": 1000,
"unfinished_reason": "DUE_TO_QUIT"
}处理程序
js
const { Formatter, Rsa, Aes } = require('wechatpay-axios-plugin')
const {
'wechatpay-nonce': wechatpayNonce,
'wechatpay-serial': wechatpaySerial,
'wechatpay-signature': wechatpaySignature,
'wechatpay-timestamp': wechatpayTimestamp,
} = headers
let code = 'SUCCESS', message = undefined
if (Math.abs(Formatter.timestamp() - wechatpayTimestamp) > MAXIMUM_CLOCK_OFFSET) {
code = 'FAIL'
message = 'Over clock offset'
}
else
if (!Object.hasOwn(platformCertificates, wechatpaySerial)) {
code = 'FAIL'
message = 'platform certificate not exists'
}
else
if (!Rsa.verify(
Formatter.joinedByLineFeed(wechatpayTimestamp, wechatpayNonce, json),
wechatpaySignature,
platformCertificates[wechatpaySerial]
)) {
code = 'FAIL'
message = 'sign mismatched'
}
// do your business
// ...
// ...
const {
id,
create_time: event_create_time,
resource_type,
event_type,
resource: {
ciphertext,
nonce,
associated_data
},
} = JSON.parse(json)
const {
appid,
card_id,
card_template_id,
create_time,
mchid,
objectives,
openid,
out_card_code,
rewards,
state,
time_range,
total_amount,
unfinished_reason,
} = JSON.parse(Aes.AesGcm.decrypt(nonce, apiv3Key, ciphertext, associated_data))
// do your business
// ...
// ...
const response = { code, message }正常应答头(headers)
Status: 200正常应答报文(body)
json
{
"code": "SUCCESS"
}注意：
- 同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。 推荐的做法是，当商户系统收到通知进行处理时，先检查对应业务数据的状态，并判断该通知是否已经处理。如果未处理，则再进行处理；如果已处理，则直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。
- 如果在所有通知频率后没有收到微信侧回调，商户应调用查询订单接口确认订单状态。
- 特别提醒：商户系统对于开启结果通知的内容一定要做签名验证，并校验通知的信息是否与商户侧的信息一致，防止数据泄露导致出现“假通知”，造成资金损失。
- 商户退款完成后，微信会把相关退款结果和用户信息发送给清算机构，清算机构需要接收处理后返回应答成功，然后继续给异步通知到下游从业机构。
- 对后台通知交互时，如果微信收到商户的应答不符合规范或超时，微信认为通知失败，微信会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但微信不保证通知最终能成功。 （通按照一定的频率重试，最多重试9次。）