DotNetCore.SKIT.FlurlHttpClient.Wechat 微信支付沙箱环境配置指南

微信支付沙箱环境概述

微信支付沙箱环境是微信官方提供的仿真测试系统，开发者可以在不影响生产环境的情况下进行支付接口的测试和验证。通过沙箱环境，开发者可以模拟各种支付场景，包括正常支付流程和异常情况测试。

配置沙箱环境接入点

在 DotNetCore.SKIT.FlurlHttpClient.Wechat 项目中，要接入微信支付沙箱环境，需要修改 API 的接入点 URL。例如：

• 生产环境付款码支付 URL：https://api.mch.weixin.qq.com/pay/micropay
• 沙箱环境应修改为：https://api.mch.weixin.qq.com/xdc/apiv2sandbox/pay/micropay

在代码实现上，可以通过构造 Client 时的 Options 参数中的 Endpoint 属性来修改接入点：

var options = new WechatTenpayClientOptions
{
    Endpoint = "https://api.mch.weixin.qq.com/xdc/apiv2sandbox"
    // 其他配置项...
};

var client = new WechatTenpayClient(options);

沙箱环境密钥管理

微信支付沙箱环境使用独立的密钥体系。开发者需要在微信支付商户平台申请沙箱环境的 API 密钥，并在项目配置中使用该密钥而非生产环境的密钥。

异常测试配置方法

微信支付沙箱环境支持通过特定的 HTTP 头部触发异常测试场景。例如，要测试签名验证失败的情况，可以在请求头中添加 Wechatpay-Negative-Test 字段。

在 DotNetCore.SKIT.FlurlHttpClient.Wechat 中，可以通过以下两种方式实现：

方法一：自定义 HttpClient

var httpClient = new HttpClient();
httpClient.DefaultRequestHeaders.Add("Wechatpay-Negative-Test", "SIGN_ERROR");

var options = new WechatTenpayClientOptions();
var client = new WechatTenpayClient(options, builder => builder.UseHttpClient(httpClient));

方法二：使用请求拦截器

public class NegativeTestInterceptor : WechatTenpayRequestInterceptor
{
    public override Task OnRequestAsync(HttpRequestMessage request)
    {
        request.Headers.Add("Wechatpay-Negative-Test", "SIGN_ERROR");
        return Task.CompletedTask;
    }
}

// 注册拦截器
var options = new WechatTenpayClientOptions();
var client = new WechatTenpayClient(options, builder => builder.AddInterceptor<NegativeTestInterceptor>());

常见沙箱测试场景

微信支付沙箱环境支持多种异常测试场景，常用的测试头包括：

• SIGN_ERROR：签名错误
• FREQUENCY_LIMITED：频率限制
• AMOUNT_LIMIT：金额超限
• PARAM_ERROR：参数错误
• SYSTEMERROR：系统错误

开发者可以根据需要选择不同的测试场景进行验证。

注意事项

1. 沙箱环境仅用于测试，不会产生真实的资金流动
2. 测试完成后，务必切换回生产环境配置
3. 沙箱环境的商户号和密钥与生产环境不同
4. 沙箱环境的证书也需要单独配置

通过合理配置 DotNetCore.SKIT.FlurlHttpClient.Wechat 的沙箱环境，开发者可以全面测试微信支付的各种场景，确保上线后的支付功能稳定可靠。