先确认支付产品与版本。V2 付款码验收使用获批商户号获取沙箱密钥，生产切换时同时核对路径、凭据与数据。

1. 按产品验收要求使用现有商户号

V2 付款码示例在获取沙箱密钥时提交获批商户号。获取成功后，使用返回的 sandbox_signkey 签署相应沙箱请求。验收路径和用例金额依产品而定。

# V2 付款码支付的两套路径与签名材料
sandbox    /xdc/apiv2sandbox/pay/micropay  sandbox_signkey
production /pay/micropay                  merchant_v2_key

这条路径可验证官方验收用例。前提是商户与产品具备相应接入资格。示例中的 merchant_v2_key 是本地配置标签，指生产 V2 API 密钥。

2. 切换时按环境整套校验

把接口、密钥引用、数据存储及所用通知路由作为一套配置部署。以下 Python 3.9.6 样例检查 V2 付款码的一组配置。callback_env 是项目的隔离标签，并非付款码接口参数。

from dataclasses import dataclass

@dataclass(frozen=True)
class Config:
    environment: str
    path: str
    key_kind: str
    callback_env: str

def check(config):
    # This allowlist models only the V2 barcode-payment product.
    expected = {
        "sandbox": ("/xdc/apiv2sandbox/pay/micropay", "sandbox_signkey"),
        "production": ("/pay/micropay", "merchant_v2_key"),
    }
    if config.environment not in expected:
        raise ValueError("unknown environment")
    if (config.path, config.key_kind) != expected[config.environment]:
        raise ValueError("path/key mismatch")
    if config.callback_env != config.environment:
        raise ValueError("callback config mismatch")

for label, config in [
    ("sandbox", Config("sandbox", "/xdc/apiv2sandbox/pay/micropay",
                       "sandbox_signkey", "sandbox")),
    ("mixed", Config("production", "/pay/micropay",
                     "sandbox_signkey", "production")),
    ("production", Config("production", "/pay/micropay",
                          "merchant_v2_key", "production")),
]:
    try:
        check(config)
    except ValueError as error:
        assert label == "mixed"
        print(label, error)
    else:
        assert label != "mixed"
        print(label, "config ok")

# 实际输出
# sandbox config ok
# mixed path/key mismatch
# production config ok

优点是混用路径和凭据类型时能在发请求前停下。限制是本地校验只识别配置标签，仍需验证密钥管理器映射到正确商户与环境。已有沙箱订单应继续在原环境排查。

3. 新接 API v3 时走该产品的接入流程

例如普通商户 JSAPI 使用 v3 的下单路径和签名机制。上线前核对产品权限、AppID 与商户绑定、请求签名、平台验签材料、APIv3 密钥和通知地址。

POST /v3/pay/transactions/jsapi
# 核对 mchid、appid、payer.openid、amount.total 与 notify_url

这适用于普通商户 JSAPI，具体测试入口应从对应产品的接入指引确认。上述本地实验未申请凭据，也未执行生产交易。

速查

先确定支付产品与 API 版本，再按对应流程验收。切换生产后，核对请求、回调和查单是否落在同一套商户配置。