Skip to content

车牌状态变更通知(XML)

从用户进入开通车主服务的停车场(用户入场通知接口),到用户离场期间(扣款接口),这个时间段内如果用户状态变为可用或者不可用,微信会把相关状态变更情况(可用/不可用)异步发送给商户,回调url为调用上述用户入场通知接口时填写的notify_url字段。商户在收到车主状态变更通知后,需进行接收处理并返回应答。

注意:

  • 对后台通知交互时,如果微信收到商户的应答不是成功或超时,微信认为通知失败,微信会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但微信不保证通知最终能成功(通知频率为6/12/24/48/96/192/384/768/1536,单位:秒)。
  • 注意:同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。
  • 推荐的做法是,当收到通知进行处理时,首先检查对应业务数据的状态,判断该通知是否已经处理过,如果没有处理过再进行处理,如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。
请求参数类型描述
headersobject通知的头参数
Request-IDstring通知的唯一标识
Content-Typestringtext/xml
bodyobject通知的XML数据结构
mch_idstring商户号
sub_mch_idstring子商户号
appidstring公众平台APPID
nonce_strstring随机字符串
sign_typestring签名类型
HMAC-SHA256 枚举值
signstring签名
plate_numberstring车牌号
vehicle_event_typestring车牌变更事件类型
NORMAL | BLOCKED 枚举值之一
vehicle_event_desstring车牌变更事件信息
OVERDUE | REMOVE | PAUSE 枚举值之一
deduct_modestring发起扣费方式
PROACTIVE | AUTOPAY 枚举值之一
vehicle_event_createtimestring车牌变更事件发生时间
php
// 使用Psr标准规范,示例如何处理(取值、转换、验签)「回调通知」事件,WebServer不同,用法略有差异,供参考实现。
function webhookProcessor(\Psr\Http\Message\RequestInterface $request,
  string $apiv2Key): array {
  if (\strlen($apiv2Key) !== 32) {
    throw new \WeChatPay\Exception\InvalidArgumentException('API密钥为32字节,长度不对');
  }

  $inBody = (string)$request->getBody();
  // 转换通知的XML文本消息为PHP Array数组
  $inBodyArray = \WeChatPay\Transformer::toArray($inBody);

  if (!\WeChatPay\Crypto\Hash::equals(\WeChatPay\Crypto\Hash::sign(
    $inBodyArray['sign_type'] ?? \WeChatPay\Crypto\ALGO_MD5,
    \WeChatPay\Formatter::queryStringLike(\WeChatPay\Formatter::ksort($inBodyArray)),
    $apiv2Key), $inBodyArray['sign'] ?? null
  )) {
    throw new \WeChatPay\Exception\InvalidArgumentException('通知的数据签名校验未通过');
  }

  return [
    'headers' => $request->getHeaders(),
    'body' => $inBodyArray
  ];
}

// do your business
// ...
// ...
$xml = \WeChatPay\Transformer::toXml([
  'return_code' => 'SUCCESS',
  'return_msg' => 'OK'
]);
应答规范类型描述
bodyobject应答的XML数据结构
return_codestring业务处理状态码
SUCCESS | FAIL 枚举值之一
return_msgstring业务处理附加信息

参阅

Published on the GitHub by TheNorthMemory