让代理充值复用现有网页支付能力

微信按当前 v2/v3 配置分别生成 MWEB/H5 链接，支付宝复用 C 端 WAP 链接，并让可用支付方式基于生效配置判断。

Constraint: 支付链接统一通过 qr_content 返回，由前端渲染二维码；按要求不运行测试

Rejected: 微信 Native 与支付宝当面付 | 会引入非当前商户配置所需的额外产品开通

Confidence: high

Scope-risk: moderate

Directive: 微信 H5/MWEB 二维码仅承诺系统相机或外部浏览器扫码链路

Tested: 相关 Go 包编译通过；gofmt 与 git diff --check 通过

Not-tested: 按用户要求未运行自动化测试及真实支付联调

internal/infrastructure/payment/alipay_wap.go

@@ -2,7 +2,7 @@ package payment
 
 import (
 	"context"
-	"strings"
+	"strconv"
 	"time"
 
 	sdkalipay "github.com/smartwalle/alipay/v3"
@@ -13,82 +13,47 @@ import (
 	alipaypkg "github.com/break/junhong_cmp_fiber/pkg/alipay"
 	"github.com/break/junhong_cmp_fiber/pkg/constants"
 	apperrors "github.com/break/junhong_cmp_fiber/pkg/errors"
+	"go.uber.org/zap"
 )
 
-// AlipayPreCreateAdapter 使用现有 smartwalle/alipay 实现当面付预下单与查单。
-type AlipayPreCreateAdapter struct {
+// AlipayWapAdapter 使用现有 C 端支付宝能力生成 WAP 支付链接并主动查单。
+type AlipayWapAdapter struct {
 	integration *integrationlog.Repository
+	logger      *zap.Logger
 }
 
-// NewAlipayPreCreateAdapter 创建支付宝当面付适配器。
-func NewAlipayPreCreateAdapter(integration *integrationlog.Repository) *AlipayPreCreateAdapter {
-	return &AlipayPreCreateAdapter{integration: integration}
+// NewAlipayWapAdapter 创建支付宝 WAP 支付适配器。
+func NewAlipayWapAdapter(integration *integrationlog.Repository, logger *zap.Logger) *AlipayWapAdapter {
+	return &AlipayWapAdapter{integration: integration, logger: logger}
 }
 
-// Available 判断配置是否完整支持支付宝预下单、验签与查单。
-func (a *AlipayPreCreateAdapter) Available(config *model.WechatConfig) bool {
+// Available 判断配置是否完整支持支付宝 WAP 支付、验签与查单。
+func (a *AlipayWapAdapter) Available(config *model.WechatConfig) bool {
 	return alipayConfigComplete(config, true)
 }
 
-// PreCreate 创建支付宝当面付扫码订单。
-func (a *AlipayPreCreateAdapter) PreCreate(ctx context.Context, request agentrecharge.OnlinePaymentRequest) (agentrecharge.OnlinePaymentResult, error) {
-	client, err := a.client(request.Config)
+// CreatePaymentURL 使用与 C 端相同的手机网站支付能力生成签名 URL。
+func (a *AlipayWapAdapter) CreatePaymentURL(ctx context.Context, request agentrecharge.OnlinePaymentRequest) (agentrecharge.OnlinePaymentResult, error) {
+	payment := &model.Payment{PaymentNo: request.PaymentNo, Amount: request.Amount, ExpireAt: &request.ExpireAt}
+	payURL, err := alipaypkg.BuildWapPayURL(ctx, request.Config, payment, request.Description)
 	if err != nil {
 		return agentrecharge.OnlinePaymentResult{}, err
 	}
-	attempt, err := a.startAttempt(ctx, request.PaymentNo, constants.IntegrationOperationPaymentPreCreate, request.Config.ID, request.Amount)
-	if err != nil {
-		return agentrecharge.OnlinePaymentResult{}, err
-	}
-	startedAt := time.Now()
-	response, callErr := client.TradePreCreate(ctx, sdkalipay.TradePreCreate{Trade: sdkalipay.Trade{
-		NotifyURL: request.Config.AliNotifyURL, Subject: request.Description, OutTradeNo: request.PaymentNo,
-		TotalAmount: alipaypkg.FenToYuan(request.Amount), ProductCode: "FACE_TO_FACE_PAYMENT",
-		TimeExpire: request.ExpireAt.Format("2006-01-02 15:04:05"),
-	}})
-	if callErr != nil {
-		return agentrecharge.OnlinePaymentResult{}, a.completeUnknown(ctx, attempt.IntegrationID, startedAt, callErr)
-	}
-	if response == nil || response.IsFailure() || strings.TrimSpace(response.QRCode) == "" {
-		providerCode, providerMessage := "empty_qr_code", "支付宝预下单未返回付款内容"
-		responseSummary := map[string]any{"success": false}
-		if response != nil && response.IsFailure() {
-			providerCode, providerMessage = string(response.Code), response.SubMsg
-			if response.SubCode != "" {
-				providerCode += ":" + response.SubCode
-				responseSummary["sub_code"] = response.SubCode
-			}
-		}
-		_, completeErr := a.integration.Complete(ctx, attempt.IntegrationID, integrationlog.Completion{
-			Result: constants.IntegrationResultFailed, ProviderCode: providerCode, ProviderMessage: providerMessage,
-			ResponseSummary: responseSummary, DurationMS: time.Since(startedAt).Milliseconds(),
-		})
-		if completeErr != nil {
-			return agentrecharge.OnlinePaymentResult{}, completeErr
-		}
-		return agentrecharge.OnlinePaymentResult{}, apperrors.New(apperrors.CodeServiceUnavailable, "支付宝预下单失败")
-	}
-	if _, err = a.integration.Complete(ctx, attempt.IntegrationID, integrationlog.Completion{
-		Result: constants.IntegrationResultSuccess, ProviderCode: string(response.Code),
-		ResponseSummary: map[string]any{"success": true}, DurationMS: time.Since(startedAt).Milliseconds(), StateChanged: true,
-	}); err != nil {
-		return agentrecharge.OnlinePaymentResult{}, err
-	}
-	return agentrecharge.OnlinePaymentResult{QRContent: response.QRCode}, nil
+	return agentrecharge.OnlinePaymentResult{QRContent: payURL}, nil
 }
 
-// Query 查询支付宝当面付订单状态。
-func (a *AlipayPreCreateAdapter) Query(ctx context.Context, paymentNo string, config *model.WechatConfig) (agentrecharge.OnlinePaymentQueryResult, error) {
-	client, err := a.queryClient(config)
+// Query 查询支付宝 WAP 支付单状态。
+func (a *AlipayWapAdapter) Query(ctx context.Context, request agentrecharge.OnlinePaymentRequest) (agentrecharge.OnlinePaymentQueryResult, error) {
+	client, err := a.queryClient(request.Config)
 	if err != nil {
 		return agentrecharge.OnlinePaymentQueryResult{}, err
 	}
-	attempt, err := a.startAttempt(ctx, paymentNo, constants.IntegrationOperationPaymentQuery, config.ID, 0)
+	attempt, err := a.startAttempt(ctx, request, constants.IntegrationOperationPaymentQuery, request.Config.ID, 0)
 	if err != nil {
 		return agentrecharge.OnlinePaymentQueryResult{}, err
 	}
 	startedAt := time.Now()
-	response, callErr := client.TradeQuery(ctx, sdkalipay.TradeQuery{OutTradeNo: paymentNo})
+	response, callErr := client.TradeQuery(ctx, sdkalipay.TradeQuery{OutTradeNo: request.PaymentNo})
 	if callErr != nil {
 		return agentrecharge.OnlinePaymentQueryResult{}, a.completeUnknown(ctx, attempt.IntegrationID, startedAt, callErr)
 	}
@@ -123,14 +88,7 @@ func (a *AlipayPreCreateAdapter) Query(ctx context.Context, paymentNo string, co
 	return result, nil
 }
 
-func (a *AlipayPreCreateAdapter) client(config *model.WechatConfig) (*sdkalipay.Client, error) {
-	if !a.Available(config) {
-		return nil, apperrors.New(apperrors.CodeNoPaymentConfig, "支付宝扫码支付配置不可用")
-	}
-	return alipaypkg.NewClientFromConfig(config)
-}
-
-func (a *AlipayPreCreateAdapter) queryClient(config *model.WechatConfig) (*sdkalipay.Client, error) {
+func (a *AlipayWapAdapter) queryClient(config *model.WechatConfig) (*sdkalipay.Client, error) {
 	if !alipayConfigComplete(config, false) {
 		return nil, apperrors.New(apperrors.CodeNoPaymentConfig, "支付宝查单配置不可用")
 	}
@@ -142,19 +100,25 @@ func alipayConfigComplete(config *model.WechatConfig, requireActive bool) bool {
 		config.AliPublicKey != "" && config.AliNotifyURL != ""
 }
 
-func (a *AlipayPreCreateAdapter) startAttempt(ctx context.Context, paymentNo, operation string, configID uint, amount int64) (*model.IntegrationLog, error) {
-	resourceID := paymentNo
+func (a *AlipayWapAdapter) startAttempt(ctx context.Context, request agentrecharge.OnlinePaymentRequest, operation string, configID uint, amount int64) (*model.IntegrationLog, error) {
+	resourceID, resourceKey := strconv.FormatUint(uint64(request.PaymentID), 10), request.PaymentNo
+	series := "agent-recharge-payment:" + resourceID + ":" + operation
+	correlationID := request.CorrelationID
 	return a.integration.Start(ctx, integrationlog.Attempt{
 		Provider: constants.IntegrationProviderAlipay, Direction: constants.IntegrationDirectionOutbound,
 		Operation: operation, ResourceType: constants.IntegrationResourceTypeAgentRechargePayment,
-		ResourceID: &resourceID, ExternalID: &resourceID,
+		ResourceID: &resourceID, ResourceKey: &resourceKey, ExternalID: &resourceKey,
+		TriggerSeries: &series, CorrelationID: &correlationID,
 		RequestSummary: map[string]any{"payment_config_id": configID, "amount": amount},
 	})
 }
 
-func (a *AlipayPreCreateAdapter) completeUnknown(ctx context.Context, integrationID string, startedAt time.Time, cause error) error {
+func (a *AlipayWapAdapter) completeUnknown(ctx context.Context, integrationID string, startedAt time.Time, cause error) error {
+	if a.logger != nil {
+		a.logger.Warn("支付宝支付请求结果未知", zap.String("integration_id", integrationID), zap.Error(cause))
+	}
 	_, err := a.integration.Complete(ctx, integrationID, integrationlog.Completion{
-		Result: constants.IntegrationResultUnknown, ProviderCode: "request_unknown", ProviderMessage: cause.Error(),
+		Result: constants.IntegrationResultUnknown, ProviderCode: "request_unknown", ProviderMessage: "支付宝支付请求结果未知",
 		ResponseSummary: map[string]any{"success": false}, DurationMS: time.Since(startedAt).Milliseconds(),
 		RecoveryStrategy: "使用原支付单号主动查单，确认不存在或关闭后才允许关闭本地支付单",
 	})

internal/infrastructure/payment/wechat_native.go

@@ -1,171 +0,0 @@
-// Package payment 提供代理在线充值使用的支付渠道薄适配器。
-package payment
-
-import (
-	"context"
-	"strings"
-	"time"
-
-	"github.com/ArtisanCloud/PowerWeChat/v3/src/kernel"
-	sdkpayment "github.com/ArtisanCloud/PowerWeChat/v3/src/payment"
-	orderRequest "github.com/ArtisanCloud/PowerWeChat/v3/src/payment/order/request"
-	"go.uber.org/zap"
-
-	agentrecharge "github.com/break/junhong_cmp_fiber/internal/application/agentrecharge"
-	"github.com/break/junhong_cmp_fiber/internal/infrastructure/integrationlog"
-	"github.com/break/junhong_cmp_fiber/internal/model"
-	"github.com/break/junhong_cmp_fiber/pkg/constants"
-	apperrors "github.com/break/junhong_cmp_fiber/pkg/errors"
-	wechatpay "github.com/break/junhong_cmp_fiber/pkg/wechat"
-)
-
-// WechatNativeAdapter 使用现有 PowerWeChat 实现 Native 预下单与查单。
-type WechatNativeAdapter struct {
-	cache       kernel.CacheInterface
-	integration *integrationlog.Repository
-	logger      *zap.Logger
-}
-
-// NewWechatNativeAdapter 创建微信 Native 支付适配器。
-func NewWechatNativeAdapter(cache kernel.CacheInterface, integration *integrationlog.Repository, logger *zap.Logger) *WechatNativeAdapter {
-	return &WechatNativeAdapter{cache: cache, integration: integration, logger: logger}
-}
-
-// Available 判断配置是否完整支持微信 Native 预下单、验签与查单。
-func (a *WechatNativeAdapter) Available(config *model.WechatConfig) bool {
-	return wechatConfigComplete(config, true)
-}
-
-// PreCreate 创建微信 Native 扫码支付单。
-func (a *WechatNativeAdapter) PreCreate(ctx context.Context, request agentrecharge.OnlinePaymentRequest) (agentrecharge.OnlinePaymentResult, error) {
-	app, err := a.paymentApp(request.Config)
-	if err != nil {
-		return agentrecharge.OnlinePaymentResult{}, err
-	}
-	attempt, err := a.startAttempt(ctx, request.PaymentNo, constants.IntegrationOperationPaymentPreCreate, request.Config.ID, request.Amount)
-	if err != nil {
-		return agentrecharge.OnlinePaymentResult{}, err
-	}
-	startedAt := time.Now()
-	response, callErr := app.Order.TransactionNative(ctx, &orderRequest.RequestNativePrepay{
-		Description: request.Description,
-		OutTradeNo:  request.PaymentNo,
-		TimeExpire:  request.ExpireAt.Format(time.RFC3339),
-		Amount:      &orderRequest.NativeAmount{Total: int(request.Amount), Currency: "CNY"},
-	})
-	if callErr != nil {
-		return agentrecharge.OnlinePaymentResult{}, a.completeUnknown(ctx, attempt.IntegrationID, startedAt, callErr)
-	}
-	if response == nil || strings.TrimSpace(response.CodeURL) == "" {
-		err = apperrors.New(apperrors.CodeWechatPayFailed, "微信 Native 预下单未返回付款内容")
-		_, completeErr := a.integration.Complete(ctx, attempt.IntegrationID, integrationlog.Completion{
-			Result: constants.IntegrationResultFailed, ProviderCode: "empty_code_url", ProviderMessage: err.Error(),
-			ResponseSummary: map[string]any{"success": false}, DurationMS: time.Since(startedAt).Milliseconds(),
-		})
-		if completeErr != nil {
-			return agentrecharge.OnlinePaymentResult{}, completeErr
-		}
-		return agentrecharge.OnlinePaymentResult{}, err
-	}
-	if _, err = a.integration.Complete(ctx, attempt.IntegrationID, integrationlog.Completion{
-		Result: constants.IntegrationResultSuccess, ResponseSummary: map[string]any{"success": true},
-		DurationMS: time.Since(startedAt).Milliseconds(), StateChanged: true,
-	}); err != nil {
-		return agentrecharge.OnlinePaymentResult{}, err
-	}
-	return agentrecharge.OnlinePaymentResult{QRContent: response.CodeURL}, nil
-}
-
-// Query 查询微信 Native 支付单状态。
-func (a *WechatNativeAdapter) Query(ctx context.Context, paymentNo string, config *model.WechatConfig) (agentrecharge.OnlinePaymentQueryResult, error) {
-	app, err := a.queryPaymentApp(config)
-	if err != nil {
-		return agentrecharge.OnlinePaymentQueryResult{}, err
-	}
-	attempt, err := a.startAttempt(ctx, paymentNo, constants.IntegrationOperationPaymentQuery, config.ID, 0)
-	if err != nil {
-		return agentrecharge.OnlinePaymentQueryResult{}, err
-	}
-	startedAt := time.Now()
-	info, callErr := wechatpay.NewPaymentService(app, a.logger).QueryOrder(ctx, paymentNo)
-	if callErr != nil {
-		return agentrecharge.OnlinePaymentQueryResult{}, a.completeUnknown(ctx, attempt.IntegrationID, startedAt, callErr)
-	}
-	result := agentrecharge.OnlinePaymentQueryResult{
-		State: mapWechatTradeState(info.TradeState), ThirdPartyTradeNo: info.TransactionID, Amount: info.TotalAmount,
-	}
-	if paidAt, parseErr := time.Parse(time.RFC3339, info.SuccessTime); parseErr == nil {
-		result.PaidAt = &paidAt
-	}
-	if _, err = a.integration.Complete(ctx, attempt.IntegrationID, integrationlog.Completion{
-		Result: constants.IntegrationResultSuccess, ProviderCode: info.TradeState,
-		ResponseSummary: map[string]any{"state": result.State, "has_trade_no": result.ThirdPartyTradeNo != ""},
-		DurationMS:      time.Since(startedAt).Milliseconds(),
-	}); err != nil {
-		return agentrecharge.OnlinePaymentQueryResult{}, err
-	}
-	return result, nil
-}
-
-func (a *WechatNativeAdapter) paymentApp(config *model.WechatConfig) (*sdkpayment.Payment, error) {
-	if !a.Available(config) {
-		return nil, apperrors.New(apperrors.CodeNoPaymentConfig, "微信 Native 支付配置不可用")
-	}
-	app, err := wechatpay.NewPaymentAppFromConfig(config, config.OaAppID, a.cache, a.logger)
-	if err != nil {
-		return nil, apperrors.Wrap(apperrors.CodeNoPaymentConfig, err, "微信 Native 支付配置不可用")
-	}
-	return app, nil
-}
-
-func (a *WechatNativeAdapter) queryPaymentApp(config *model.WechatConfig) (*sdkpayment.Payment, error) {
-	if !wechatConfigComplete(config, false) {
-		return nil, apperrors.New(apperrors.CodeNoPaymentConfig, "微信查单配置不可用")
-	}
-	app, err := wechatpay.NewPaymentAppFromConfig(config, config.OaAppID, a.cache, a.logger)
-	if err != nil {
-		return nil, apperrors.Wrap(apperrors.CodeNoPaymentConfig, err, "微信查单配置不可用")
-	}
-	return app, nil
-}
-
-func wechatConfigComplete(config *model.WechatConfig, requireActive bool) bool {
-	return config != nil && (!requireActive || config.IsActive) && config.ProviderType == model.ProviderTypeWechat &&
-		config.OaAppID != "" && config.WxMchID != "" && config.WxAPIV3Key != "" &&
-		config.WxCertContent != "" && config.WxKeyContent != "" && config.WxSerialNo != "" && config.WxNotifyURL != ""
-}
-
-func (a *WechatNativeAdapter) startAttempt(ctx context.Context, paymentNo, operation string, configID uint, amount int64) (*model.IntegrationLog, error) {
-	resourceID := paymentNo
-	return a.integration.Start(ctx, integrationlog.Attempt{
-		Provider: constants.IntegrationProviderWechatPay, Direction: constants.IntegrationDirectionOutbound,
-		Operation: operation, ResourceType: constants.IntegrationResourceTypeAgentRechargePayment,
-		ResourceID: &resourceID, ExternalID: &resourceID,
-		RequestSummary: map[string]any{"payment_config_id": configID, "amount": amount},
-	})
-}
-
-func (a *WechatNativeAdapter) completeUnknown(ctx context.Context, integrationID string, startedAt time.Time, cause error) error {
-	_, err := a.integration.Complete(ctx, integrationID, integrationlog.Completion{
-		Result: constants.IntegrationResultUnknown, ProviderCode: "request_unknown", ProviderMessage: cause.Error(),
-		ResponseSummary: map[string]any{"success": false}, DurationMS: time.Since(startedAt).Milliseconds(),
-		RecoveryStrategy: "使用原支付单号主动查单，确认不存在或关闭后才允许关闭本地支付单",
-	})
-	if err != nil {
-		return err
-	}
-	return apperrors.Wrap(apperrors.CodeTimeout, cause, "微信支付请求结果未知")
-}
-
-func mapWechatTradeState(state string) string {
-	switch state {
-	case "SUCCESS":
-		return agentrecharge.OnlinePaymentStatePaid
-	case "CLOSED", "REVOKED", "PAYERROR":
-		return agentrecharge.OnlinePaymentStateClosed
-	case "NOTPAY", "USERPAYING":
-		return agentrecharge.OnlinePaymentStatePending
-	default:
-		return agentrecharge.OnlinePaymentStateUnknown
-	}
-}

internal/infrastructure/payment/wechat_web.go

@@ -0,0 +1,208 @@
+// Package payment 提供代理在线充值使用的支付渠道薄适配器。
+package payment
+
+import (
+	"context"
+	"strconv"
+	"time"
+
+	"github.com/ArtisanCloud/PowerWeChat/v3/src/kernel"
+	sdkpayment "github.com/ArtisanCloud/PowerWeChat/v3/src/payment"
+	"go.uber.org/zap"
+
+	agentrecharge "github.com/break/junhong_cmp_fiber/internal/application/agentrecharge"
+	"github.com/break/junhong_cmp_fiber/internal/infrastructure/integrationlog"
+	"github.com/break/junhong_cmp_fiber/internal/model"
+	"github.com/break/junhong_cmp_fiber/pkg/constants"
+	apperrors "github.com/break/junhong_cmp_fiber/pkg/errors"
+	wechatpay "github.com/break/junhong_cmp_fiber/pkg/wechat"
+)
+
+// WechatWebAdapter 按当前支付配置生成微信 H5/MWEB 支付链接并查单。
+type WechatWebAdapter struct {
+	cache       kernel.CacheInterface
+	integration *integrationlog.Repository
+	logger      *zap.Logger
+}
+
+// NewWechatWebAdapter 创建微信 H5/MWEB 支付适配器。
+func NewWechatWebAdapter(cache kernel.CacheInterface, integration *integrationlog.Repository, logger *zap.Logger) *WechatWebAdapter {
+	return &WechatWebAdapter{cache: cache, integration: integration, logger: logger}
+}
+
+// Available 判断当前协议配置是否完整支持 H5/MWEB 下单、验签与查单。
+func (a *WechatWebAdapter) Available(config *model.WechatConfig) bool {
+	return wechatConfigComplete(config, true) || wechatV2ConfigComplete(config, true)
+}
+
+// CreatePaymentURL 按当前协议生成微信 H5 或 MWEB 支付链接。
+func (a *WechatWebAdapter) CreatePaymentURL(ctx context.Context, request agentrecharge.OnlinePaymentRequest) (agentrecharge.OnlinePaymentResult, error) {
+	attempt, err := a.startAttempt(ctx, request, constants.IntegrationOperationPaymentPreCreate, request.Config.ID, request.Amount)
+	if err != nil {
+		return agentrecharge.OnlinePaymentResult{}, err
+	}
+	startedAt := time.Now()
+	response, callErr := a.createH5Order(ctx, request, &wechatpay.H5SceneInfo{
+		PayerClientIP: request.PayerClientIP,
+		H5Type:        "Wap",
+	})
+	if callErr != nil {
+		return agentrecharge.OnlinePaymentResult{}, a.completeUnknown(ctx, attempt.IntegrationID, startedAt, callErr)
+	}
+	if _, err = a.integration.Complete(ctx, attempt.IntegrationID, integrationlog.Completion{
+		Result: constants.IntegrationResultSuccess, ResponseSummary: map[string]any{"success": true},
+		DurationMS: time.Since(startedAt).Milliseconds(), StateChanged: true,
+	}); err != nil {
+		return agentrecharge.OnlinePaymentResult{}, err
+	}
+	return agentrecharge.OnlinePaymentResult{QRContent: response.H5URL}, nil
+}
+
+// Query 按创建支付单时的协议查询微信支付状态。
+func (a *WechatWebAdapter) Query(ctx context.Context, request agentrecharge.OnlinePaymentRequest) (agentrecharge.OnlinePaymentQueryResult, error) {
+	attempt, err := a.startAttempt(ctx, request, constants.IntegrationOperationPaymentQuery, request.Config.ID, 0)
+	if err != nil {
+		return agentrecharge.OnlinePaymentQueryResult{}, err
+	}
+	startedAt := time.Now()
+	info, callErr := a.queryOrder(ctx, request.Config, request.PaymentNo)
+	if callErr != nil {
+		return agentrecharge.OnlinePaymentQueryResult{}, a.completeUnknown(ctx, attempt.IntegrationID, startedAt, callErr)
+	}
+	result := agentrecharge.OnlinePaymentQueryResult{
+		State: mapWechatTradeState(info.TradeState), ThirdPartyTradeNo: info.TransactionID, Amount: info.TotalAmount,
+	}
+	if paidAt, ok := parseWechatPaidAt(info.SuccessTime); ok {
+		result.PaidAt = &paidAt
+	}
+	if _, err = a.integration.Complete(ctx, attempt.IntegrationID, integrationlog.Completion{
+		Result: constants.IntegrationResultSuccess, ProviderCode: info.TradeState,
+		ResponseSummary: map[string]any{"state": result.State, "has_trade_no": result.ThirdPartyTradeNo != ""},
+		DurationMS:      time.Since(startedAt).Milliseconds(),
+	}); err != nil {
+		return agentrecharge.OnlinePaymentQueryResult{}, err
+	}
+	return result, nil
+}
+
+func parseWechatPaidAt(value string) (time.Time, bool) {
+	for _, layout := range []string{time.RFC3339, "20060102150405"} {
+		paidAt, err := time.ParseInLocation(layout, value, time.Local)
+		if err == nil {
+			return paidAt, true
+		}
+	}
+	return time.Time{}, false
+}
+
+func (a *WechatWebAdapter) paymentApp(config *model.WechatConfig) (*sdkpayment.Payment, error) {
+	if !wechatConfigComplete(config, false) {
+		return nil, apperrors.New(apperrors.CodeNoPaymentConfig, "微信 H5 支付配置不可用")
+	}
+	app, err := wechatpay.NewPaymentAppFromConfig(config, config.OaAppID, a.cache, a.logger)
+	if err != nil {
+		return nil, apperrors.Wrap(apperrors.CodeNoPaymentConfig, err, "微信 H5 支付配置不可用")
+	}
+	return app, nil
+}
+
+func (a *WechatWebAdapter) createH5Order(ctx context.Context, request agentrecharge.OnlinePaymentRequest, sceneInfo *wechatpay.H5SceneInfo) (*wechatpay.H5PayResult, error) {
+	switch request.Config.ProviderType {
+	case model.ProviderTypeWechat:
+		app, err := a.paymentApp(request.Config)
+		if err != nil {
+			return nil, err
+		}
+		return wechatpay.NewPaymentService(app, a.logger).CreateH5Order(ctx, request.PaymentNo, request.Description, int(request.Amount), sceneInfo)
+	case model.ProviderTypeWechatV2:
+		service, err := wechatpay.NewPaymentV2ServiceFromConfig(request.Config, request.Config.OaAppID, a.logger)
+		if err != nil {
+			return nil, apperrors.Wrap(apperrors.CodeNoPaymentConfig, err, "微信 MWEB 支付配置不可用")
+		}
+		return service.CreateH5Order(ctx, request.PaymentNo, request.Description, int(request.Amount), sceneInfo)
+	default:
+		return nil, apperrors.New(apperrors.CodeNoPaymentConfig, "当前支付渠道不支持微信网页支付")
+	}
+}
+
+func (a *WechatWebAdapter) queryOrder(ctx context.Context, config *model.WechatConfig, paymentNo string) (*wechatpay.OrderInfo, error) {
+	switch config.ProviderType {
+	case model.ProviderTypeWechat:
+		app, err := a.queryPaymentApp(config)
+		if err != nil {
+			return nil, err
+		}
+		return wechatpay.NewPaymentService(app, a.logger).QueryOrder(ctx, paymentNo)
+	case model.ProviderTypeWechatV2:
+		service, err := wechatpay.NewPaymentV2ServiceFromConfig(config, config.OaAppID, a.logger)
+		if err != nil {
+			return nil, apperrors.Wrap(apperrors.CodeNoPaymentConfig, err, "微信 v2 查单配置不可用")
+		}
+		return service.QueryOrder(ctx, paymentNo)
+	default:
+		return nil, apperrors.New(apperrors.CodeNoPaymentConfig, "当前支付渠道不支持微信查单")
+	}
+}
+
+func (a *WechatWebAdapter) queryPaymentApp(config *model.WechatConfig) (*sdkpayment.Payment, error) {
+	if !wechatConfigComplete(config, false) {
+		return nil, apperrors.New(apperrors.CodeNoPaymentConfig, "微信查单配置不可用")
+	}
+	app, err := wechatpay.NewPaymentAppFromConfig(config, config.OaAppID, a.cache, a.logger)
+	if err != nil {
+		return nil, apperrors.Wrap(apperrors.CodeNoPaymentConfig, err, "微信查单配置不可用")
+	}
+	return app, nil
+}
+
+func wechatConfigComplete(config *model.WechatConfig, requireActive bool) bool {
+	return config != nil && (!requireActive || config.IsActive) && config.ProviderType == model.ProviderTypeWechat &&
+		config.OaAppID != "" && config.WxMchID != "" && config.WxAPIV3Key != "" &&
+		config.WxCertContent != "" && config.WxKeyContent != "" && config.WxSerialNo != "" && config.WxNotifyURL != ""
+}
+
+func wechatV2ConfigComplete(config *model.WechatConfig, requireActive bool) bool {
+	return config != nil && (!requireActive || config.IsActive) && config.ProviderType == model.ProviderTypeWechatV2 &&
+		config.OaAppID != "" && config.WxMchID != "" && config.WxAPIV2Key != "" && config.WxNotifyURL != ""
+}
+
+func (a *WechatWebAdapter) startAttempt(ctx context.Context, request agentrecharge.OnlinePaymentRequest, operation string, configID uint, amount int64) (*model.IntegrationLog, error) {
+	resourceID, resourceKey := strconv.FormatUint(uint64(request.PaymentID), 10), request.PaymentNo
+	series := "agent-recharge-payment:" + resourceID + ":" + operation
+	correlationID := request.CorrelationID
+	return a.integration.Start(ctx, integrationlog.Attempt{
+		Provider: constants.IntegrationProviderWechatPay, Direction: constants.IntegrationDirectionOutbound,
+		Operation: operation, ResourceType: constants.IntegrationResourceTypeAgentRechargePayment,
+		ResourceID: &resourceID, ResourceKey: &resourceKey, ExternalID: &resourceKey,
+		TriggerSeries: &series, CorrelationID: &correlationID,
+		RequestSummary: map[string]any{"payment_config_id": configID, "amount": amount},
+	})
+}
+
+func (a *WechatWebAdapter) completeUnknown(ctx context.Context, integrationID string, startedAt time.Time, cause error) error {
+	if a.logger != nil {
+		a.logger.Warn("微信支付请求结果未知", zap.String("integration_id", integrationID), zap.Error(cause))
+	}
+	_, err := a.integration.Complete(ctx, integrationID, integrationlog.Completion{
+		Result: constants.IntegrationResultUnknown, ProviderCode: "request_unknown", ProviderMessage: "微信支付请求结果未知",
+		ResponseSummary: map[string]any{"success": false}, DurationMS: time.Since(startedAt).Milliseconds(),
+		RecoveryStrategy: "使用原支付单号主动查单，确认不存在或关闭后才允许关闭本地支付单",
+	})
+	if err != nil {
+		return err
+	}
+	return apperrors.Wrap(apperrors.CodeTimeout, cause, "微信支付请求结果未知")
+}
+
+func mapWechatTradeState(state string) string {
+	switch state {
+	case "SUCCESS":
+		return agentrecharge.OnlinePaymentStatePaid
+	case "CLOSED", "REVOKED", "PAYERROR":
+		return agentrecharge.OnlinePaymentStateClosed
+	case "NOTPAY", "USERPAYING":
+		return agentrecharge.OnlinePaymentStatePending
+	default:
+		return agentrecharge.OnlinePaymentStateUnknown
+	}
+}