wechatpay.im

主题模式

停车缴费服务-商户查费(PARKING_FEE.QUERY_TRANS_INFO)回调(JSON) ​

当微信支付需要获取某笔停车的实时计费信息时，会向商户预先配置的查费接口地址发起查询请求。商户需根据请求中的停车单信息，返回当前费用、停车状态、支付状态等交易信息。

注意：

  • 回调地址设置方式：回调地址通过商户进件信息的「查询缴费信息接口url」（parking_info_scv_url）设置
  • 连接超时 2 秒、读写超时 3 秒、code 非 SUCCESS 均视为查费失败
  • 返回的 parking_state、pay_state 及费用字段须与商户系统内该停车单的真实状态一致
请求参数类型描述
headersobject通知的头参数
Content-Typestringapplication/json
Request-IDstring通知的唯一标识
Wechatpay-Noncestring数据签名使用的随机串
Wechatpay-Serialstring微信支付公钥ID/平台证书序列号
Wechatpay-Signaturestring签名串
Wechatpay-Signature-Typestring签名算法
WECHATPAY2-SHA256-RSA2048 枚举值
Wechatpay-Timestampstring时间戳
bodyobject通知的JSON数据结构
idstring通知的唯一ID
create_timestring通知创建的时间
event_typestring通知的类型
PARKING_FEE.QUERY_TRANS_INFO 枚举值
resource_typestring通知的资源数据类型
summarystring回调摘要
resourceobject通知资源数据
original_typestring原始回调类型
parking_fee 枚举值
algorithmstring对数据进行加密的加密算法
AEAD_AES_256_GCM 枚举值
associated_datastring数据加密的附加数据
noncestring加密使用的随机串
ciphertextstring加密后的密文数据
out_serial_numberstring商户停车单号
plate_numberstring车牌号
out_parking_idstring商户停车场ID
php
// 使用Psr标准规范，示例如何处理(取值、验签、解密)「回调通知」事件，WebServer不同，用法略有差异，供参考实现。
function webhookProcessor(\Psr\Http\Message\RequestInterface $request,
  array $platformPublicKeyMap, string $apiv3Key): array {
  if (!\count($platformPublicKeyMap)) {
    throw new \WeChatPay\Exception\InvalidArgumentException('平台证书或者平台公钥数组不能为空');
  }

  if (\strlen($apiv3Key) !== 32) {
    throw new \WeChatPay\Exception\InvalidArgumentException('APIV3密钥为32字节，长度不对');
  }

  if (!($request->hasHeader(\WeChatPay\WechatpayNonce)
    && $request->hasHeader(\WeChatPay\WechatpaySerial)
    && $request->hasHeader(\WeChatPay\WechatpaySignature)
    && $request->hasHeader(\WeChatPay\WechatpayTimestamp))) {
    throw new \WeChatPay\Exception\InvalidArgumentException('通知的头参数缺失必要参数');
  }

  // 检查通知的时间偏移量，允许5分钟之内的偏移
  [$inWechatpayTimestamp] = $request->getHeader(\WeChatPay\WechatpayTimestamp);
  if (\WeChatPay\MAXIMUM_CLOCK_OFFSET < \abs(
    \WeChatPay\Formatter::timestamp() - (int)$inWechatpayTimestamp)) {
    throw new \WeChatPay\Exception\InvalidArgumentException('通知头参数的时间偏移量超过可信阈值');
  }

  // 检查通知的平台证书/平台公钥实例是否存在
  [$inWechatpaySerial] = $request->getHeader(\WeChatPay\WechatpaySerial);
  if (!\array_key_exists($inWechatpaySerial, $platformPublicKeyMap)) {
    throw new \WeChatPay\Exception\InvalidArgumentException('通知头参数的证书序列号/公钥ID本地不存在');
  }

  // 验证通知的数据签名
  [$inWechatpaySignature] = $request->getHeader(\WeChatPay\WechatpaySignature);
  [$inWechatpayNonce] = $request->getHeader(\WeChatPay\WechatpayNonce);
  $inBody = (string)$request->getBody();
  if (!\WeChatPay\Crypto\Rsa::verify(
    \WeChatPay\Formatter::joinedByLineFeed($inWechatpayTimestamp, $inWechatpayNonce, $inBody),
    $inWechatpaySignature, $platformPublicKeyMap[$inWechatpaySerial]
  )) {
    throw new \WeChatPay\Exception\InvalidArgumentException('通知头参数的数据签名校验未通过');
  }

  // 转换通知的JSON文本消息为PHP Array数组
  $inBodyArray = (array)\json_decode($inBody, true);
  // 使用PHP7+的数据解构语法，从Array中解构并赋值变量
  ['resource' => [
    'ciphertext'      => $ciphertext,
    'nonce'           => $nonce,
    'associated_data' => $aad
  ]] = $inBodyArray;
  // 加密文本消息解密，有可能解密异常(eg: 平台探测流量)会抛 \UnexpectedValueException
  $inBodyResource = \WeChatPay\Crypto\AesGcm::decrypt($ciphertext, $apiv3Key, $nonce, $aad);
  // 把解密后的文本转换为PHP Array数组
  $inBodyResourceArray = (array)\json_decode($inBodyResource, true);
  // 把解密后的数组定义为'original_data'函数返回
  $inBodyArray['resource']['original_data'] = $inBodyResourceArray;

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

// do your business
// ...
// ...
$json = \json_encode([
  'code' => 'SUCCESS',
  'message' => 'OK',
  'total_amount' => 1500,
  'parking_timestamp' => 3600,
  'parking_state' => 'PARKING_STATUS_PARKING',
  'pay_state' => 'PAY_STATUS_UNPAID',
  'allowed_exit_timestamp' => 900,
  'next_raise_price' => 2000,
  'next_raise_timestamp' => 1719132575,
  'payable_amount' => 1500,
  'paid_amount' => 0,
]);
应答规范类型描述
statusnumberHTTP状态码
20X 4XX 5XX 枚举值之一
bodyobject应答的JSON数据结构
codestring业务处理状态码
SUCCESS | FAIL 枚举值之一
messagestring业务处理附加信息
total_amountinteger当前总费用
parking_timestampinteger已停时长
parking_statestring停车状态
PARKING_STATE_UNKNOWN | PARKING_STATE_ENTERED | PARKING_STATE_EXIT_GATE | PARKING_STATE_EXITED | PARKING_STATE_UNEXPECTED_CLOSE 枚举值之一
pay_statestring支付状态
PAY_STATUS_UNKNOWN | PAY_STATUS_UNPAID | PAY_STATUS_PAID 枚举值之一
allowed_exit_timestampinteger免费待出场时间
next_raise_priceinteger下一次跳价价格
next_raise_timestampinteger下一次跳价时间
payable_amountinteger应付金额
paid_amountinteger已付金额

参阅 官方文档

Published on the GitHub by TheNorthMemory