fix: 微信 H5 下单被明确拒绝时报真实原因并关单,不再显示请求超时
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Has been cancelled

微信 v2 统一下单返回 result_code=FAIL(如 NOAUTH 商户未开通 H5 产品)时订单未创建,
原来一律按结果未知返回"请求超时"、订单挂到支付截止才关。改为验签后按明确失败返回微信原因,
调用方立即关单;用微信配置不可用错误码,不触发商户自动停用。ORDERPAID、OUT_TRADE_NO_USED、SYSTEMERROR 仍按未知处理。
This commit is contained in:
邹进
2026-11-07 22:12:42 +09:00
parent b2fc74c021
commit 7b13431f36
3 changed files with 95 additions and 0 deletions

View File

@@ -85,6 +85,35 @@ type v2UnifiedOrderResponse struct {
MwebURL string `xml:"mweb_url"`
}
// V2BusinessError 是微信 v2 统一下单明确返回业务失败(result_code=FAIL),订单未在微信侧创建。
// 调用方据此直接报真实原因并关闭本地订单,而不是按"结果未知"等待查单。
type V2BusinessError struct {
Code string
Message string
}
func (e *V2BusinessError) Error() string {
return fmt.Sprintf("微信支付下单被拒绝:%s(%s)", e.Message, e.Code)
}
// v2UnifiedOrderUncertainCodes 是业务失败但订单可能已存在或结果不确定的错误码,仍按结果未知处理。
var v2UnifiedOrderUncertainCodes = map[string]bool{"ORDERPAID": true, "OUT_TRADE_NO_USED": true, "SYSTEMERROR": true}
// v2BusinessFailure 判断统一下单响应是否为明确的业务失败;只有签名校验通过的响应才认定,避免伪造响应误关单。
func v2BusinessFailure(resp v2UnifiedOrderResponse, respBytes []byte, apiKey string) *V2BusinessError {
if resp.ReturnCode != "SUCCESS" || resp.ResultCode != "FAIL" || resp.ErrCode == "" || v2UnifiedOrderUncertainCodes[resp.ErrCode] {
return nil
}
if verifyV2ResponseSign(respBytes, apiKey) != nil {
return nil
}
message := resp.ErrCodeDes
if message == "" {
message = resp.ErrCode
}
return &V2BusinessError{Code: resp.ErrCode, Message: message}
}
// v2OrderQueryRequest 商户订单号查单请求(v2 XML 格式)
type v2OrderQueryRequest struct {
XMLName xml.Name `xml:"xml"`
@@ -266,6 +295,9 @@ func (s *PaymentV2Service) CreateH5Order(ctx context.Context, orderNo, descripti
if resp.ReturnCode != "SUCCESS" || resp.ResultCode != "SUCCESS" || resp.MwebURL == "" {
s.logger.Error("微信 v2 MWEB 统一下单失败", zap.String("order_no", orderNo), zap.String("return_code", resp.ReturnCode),
zap.String("return_msg", resp.ReturnMsg), zap.String("result_code", resp.ResultCode), zap.String("err_code", resp.ErrCode), zap.String("err_code_des", resp.ErrCodeDes))
if bizErr := v2BusinessFailure(resp, respBytes, s.apiKey); bizErr != nil {
return nil, bizErr
}
return nil, errors.New(errors.CodeWechatPayFailed, "创建 H5 支付订单失败")
}
if err = verifyV2ResponseSign(respBytes, s.apiKey); err != nil {