微信公众号支付在正式上线前，通常需要在沙箱环境完成支付链路验证。沙箱环境提供了一个独立于生产环境的测试区域，商户号、API密钥、回调地址均与生产环境隔离。如果开发者直接把生产环境参数套用到沙箱接口，往往会遇到签名失败或金额校验异常。本文围绕沙箱环境的配置流程和测试金额限制展开说明，帮助快速完成支付验收。
一、沙箱商户号与API密钥配置
进入微信支付商户平台，在开发者中心找到沙箱环境入口。系统会为当前登录主体分配一个独立的沙箱商户号，例如 1900000109 这类虚拟号段。沙箱商户号与真实商户号完全隔离，不能混用。部分开发者习惯把生产环境的 mch_id 和 key 直接复制到沙箱测试代码中，结果导致 MCH_NOT_EXISTS 或签名错误。
沙箱环境中的 API 密钥需要单独设置。商户平台沙箱管理页面会提供密钥修改入口，该密钥与生产环境 API 密钥互不影响。建议将沙箱参数集中放在配置文件中，例如：
// 沙箱环境配置
$config = [
'appid' => 'wx1234567890abcdef',
'mch_id' => '1900000109',
'key' => 'sandbox_api_key_32_chars',
'notify_url' => 'https://www.ipipp.com/notify'
];
完成密钥配置后，还需要确认公众号支付授权目录是否正确。沙箱环境下的支付授权目录通常与生产环境配置独立，需要登录公众号后台或商户平台沙箱模块单独维护。如果授权目录不匹配，即使统一下单成功，前端调起支付时也可能提示 URL 未注册。
二、统一下单接口的沙箱地址与参数差异
微信公众号支付依赖统一下单接口获取 prepay_id，再用该参数调起 JSAPI 支付。沙箱环境的统一下单地址与生产环境并不相同：
- 生产环境地址：
https://api.mch.weixin.qq.com/pay/unifiedorder - 沙箱环境地址：
https://api.mch.weixin.qq.com/sandboxnew/pay/unifiedorder
可以看到沙箱地址在路径中多了 sandboxnew 这一层。调用时必须使用沙箱商户号、沙箱 appid 和沙箱密钥，否则接口会返回 NOAUTH 或 MCHID_NOT_EXIST。下面是一段 PHP 发起沙箱统一下单的完整示例：
function buildUnifiedOrder($order)
{
$params = [
'appid' => 'wx1234567890abcdef',
'mch_id' => '1900000109',
'nonce_str' => bin2hex(random_bytes(16)),
'body' => '沙箱测试商品',
'out_trade_no' => 'SANDBOX' . date('YmdHis'),
'total_fee' => $order['total_fee'],
'spbill_create_ip' => '127.0.0.1',
'notify_url' => 'https://www.ipipp.com/notify',
'trade_type' => 'JSAPI',
'openid' => $order['openid'],
];
ksort($params);
$stringA = urldecode(http_build_query($params));
$stringSignTemp = $stringA . '&key=sandbox_api_key_32_chars';
$params['sign'] = strtoupper(md5($stringSignTemp));
return $params;
}
请求成功后会返回 XML 结构，其中 prepay_id 是前端调起支付的必要参数。沙箱环境不会产生真实资金流水，支付成功后商户后台的订单状态会显示为已经支付，但资金不会真实扣除，因此特别适合验证支付回调、订单状态流转和退款流程。
注意，前端调起微信支付时需要再次生成签名。这个签名必须和统一下单时使用的商户号、appid 保持一致，沙箱环境对此类一致性校验比生产环境更严格。
三、沙箱测试金额限制说明
沙箱环境对订单金额字段 total_fee 的限制主要集中在单位、范围和一致性三个方面。金额单位是分，必须为整数，不能传入小数、空格或负数。比如要测试 1 元订单，应该传 100，而不是 1 或 1.00。如果金额被 PHP 自动转换为浮点数，签名前后可能会出现不一致，最终报 SIGNERROR。
沙箱环境下单金额建议控制在 1 分到 100 元之间。部分商户发现单笔金额超过 100 元时接口返回 MONEY_LIMIT，这并不是代码逻辑错误，而是沙箱商户号本身的额度限制。如果需要测试大额支付，可以通过拆分订单进行多次小额验收，或者联系微信支付对沙箱商户号做额度调整。金额字段在参与签名后不能修改，任何对金额的二次处理都要在签名之前完成。
下面是一段简单的金额校验逻辑，可以在下单前拦截非法金额：
$totalFee = $request->input('total_fee');
if (!ctype_digit((string)$totalFee) || $totalFee <= 0) {
throw new Exception('金额必须为正整数分');
}
if ($totalFee > 10000) {
throw new Exception('沙箱环境单笔金额建议不超过100元');
}
除了金额范围，退款测试还需要注意退款金额不能大于原订单金额。沙箱环境虽然不涉及真实资金，但退款接口对金额的校验与生产环境一致。常见错误码 ORDERPAID 表示订单已经支付，如果在测试中重复下单而没有更换订单号，就会触发该错误。遇到金额类报错时，优先检查金额单位是否为分、签名是否由原始参数生成、以及请求中是否混用了生产环境参数。
掌握以上配置和金额规则后，公众号支付的沙箱验收可以更顺畅地完成。回调地址不要使用 localhost，应使用内网穿透工具提供可公网访问的 HTTPS 地址，并保证回调返回的 SUCCESS 字符串不包含多余空格。