明确结论

沙箱环境不应默认跳过签约、直接代扣。

商家扣款通常要求用户先完成有效签约。即使部分沙箱账号、测试工具或特定测试场景允许直接发起扣款，也不能说明正式环境可以免签约。沙箱能否完整测试签约页面、协议查询和代扣，还要看支付平台、产品权限和沙箱开放的能力。

建议按以下顺序处理：完成签约并取得有效协议号，查询并确认协议状态，再使用该协议号发起代扣。

为什么不能直接代扣

普通支付需要用户逐笔确认，代扣则以用户事先授权的协议为依据。支付平台通常会检查：

• 商户是否已开通商家扣款产品；
• 当前应用和商户账号是否具备相应权限；
• 用户是否有有效的签约协议；
• 协议号是否属于当前商户和应用；
• 扣款金额、频率及业务场景是否符合协议约定；
• 订单号是否重复，协议是否已经失效或解约。

签约不只是为了取得测试参数，也是代扣请求的授权依据。没有有效协议，正式环境中的扣款请求通常会被拒绝。

推荐的签约与代扣流程

1. 确认沙箱能力和产品权限

先在开发者后台确认商家扣款产品已经开通，并检查该产品是否支持沙箱测试。

如果沙箱文档明确注明“不提供完整签约流程”或“使用固定测试协议号”，应按对应产品的沙箱说明操作。这只是沙箱中的模拟方式，不能直接用于正式环境。

2. 创建签约请求

服务端调用平台提供的签约接口。例如，支付宝相关产品可能使用：

alipay.user.agreement.page.sign

签约请求通常要包含商户签约号、签约产品码、回跳地址和异步通知地址等信息。具体字段以当前产品文档为准，不同代扣产品的参数不能混用。

以下代码仅用于说明流程，不是可以直接运行的完整参数：

AlipayUserAgreementPageSignRequest request =
        new AlipayUserAgreementPageSignRequest();

request.setReturnUrl("https://example.com/agreement/return");
request.setNotifyUrl("https://example.com/agreement/notify");
request.setBizContent("""
{
  "external_agreement_no": "AGREEMENT_202609130001",
  "personal_product_code": "<以产品文档为准>"
}
""");

String signPage = alipayClient.pageExecute(request).getBody();

服务端生成签约页面地址或表单后，再引导用户前往平台页面完成授权。签名参数不要交给前端自行拼接。

3. 接收并验证签约结果

用户完成签约后，平台一般会发送异步通知。商户服务端需要：

1. 验证通知签名；
2. 校验应用、商户和签约业务号；
3. 检查签约状态；
4. 保存平台返回的协议号；
5. 对通知做幂等处理。

不能只凭浏览器回跳页面判断签约成功。用户可能关闭页面，网络也可能中断，而且回跳参数无法代替服务端验签。

4. 主动查询协议状态

收到通知后，建议再调用协议查询接口确认最终状态。例如，相关产品可能使用：

alipay.user.agreement.query

查询结果明确显示协议已经生效后，才能将其标记为可扣款。数据库至少应记录：

{
  "external_agreement_no": "AGREEMENT_202609130001",
  "agreement_no": "<平台返回的协议号>",
  "status": "NORMAL"
}

这里的状态值只用于表达处理逻辑，实际枚举值应以接口文档和真实响应为准。

5. 使用有效协议发起代扣

协议生效后，再调用对应产品指定的支付或扣款接口。部分支付宝代扣场景可能通过：

alipay.trade.pay

发起扣款。但具体使用哪个接口、产品码和协议参数，取决于已经开通的扣款产品，不能仅凭“商家扣款”这一名称判断。

服务端应先检查协议状态，再构造扣款请求：

Agreement agreement = agreementRepository.findByUserId(userId);

if (agreement == null || !agreement.isEffective()) {
    throw new IllegalStateException("用户尚未完成有效签约，不能发起代扣");
}

// 使用产品文档规定的扣款接口。
// 请求中应关联平台协议号、唯一商户订单号和实际扣款金额。
DeductResult result = deductService.pay(
        agreement.getAgreementNo(),
        merchantOrderNo,
        amount
);

这段代码只说明调用顺序。Agreement、DeductResult 和 deductService.pay 是业务层示意，不是支付平台提供的 API。

6. 查询并确认扣款结果

如果代扣请求返回处理中、超时或结果不明确，不要马上创建新订单重试。应使用原商户订单号查询支付结果，并结合异步通知更新订单状态。

状态可以按以下方式处理：

签约中 → 已生效 → 可代扣
                  ↓
          扣款处理中 → 成功
                  └→ 失败

扣款失败后能否重试，需要根据错误码判断。参数错误、协议失效和权限不足不应直接重试；遇到网络超时等结果未知的情况，应先查询原订单。

注意事项

• 沙箱和正式环境的应用标识、网关地址、密钥及账号通常彼此隔离，协议号也不能跨环境使用。
• 不要手工伪造协议号，也不要把其他沙箱用户的协议号用于当前用户。
• 商户签约号和商户订单号应保持唯一，并在服务端设置唯一约束。
• 金额应按平台要求的单位和精度处理，避免直接使用二进制浮点数计算。
• 签约通知和支付通知都必须验签，同时校验通知中的主要业务字段。
• 用户解约、协议过期或平台暂停协议后，应立即停止代扣。
• 上线前需要在正式环境重新签约，沙箱签约数据通常无法迁移到正式环境。
• 如果当前沙箱没有提供签约能力，应向平台确认指定的模拟方式。只有官方文档明确提供固定协议号或免签约测试入口，才能在沙箱中按该方式测试。

备注：内容仅供参考。