免密代扣说明
======

免密代扣包括支付并签约以及签约代扣场景。

开发者接入免密支付前需先申请开通签约代扣产品（即申请**配置免密代扣模板**和获取**协议模板ID**），产品开通参见[产品开通操作](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/payment-product-configuration#场景一产品开通操作)。

华为支付以模板维度管理每个代扣扣费服务，主要组成要素如下：

| 字段含义 | 开发者对接字段 | 说明 |
| :-- | :-- | :-- |
| 协议模板ID | planId | 由华为支付分配的唯一模板ID，开发对接免密支付的必选参数之一。 |
| 商户签约协议号 | mercContractCode | 商户签约协议号。开发者请求签约时传入的签约协议号，由商户生成，商户需保证字段唯一性。最大长度64。 |
| 委托代扣协议ID | contractId | 即华为签约标识。商户与用户签约成功后从华为支付签约回调通知中返回给商户或通过[直连商户查询签约信息](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/payment-withhold-query-contractcode)或[服务商查询签约信息](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/payment-partner-withhold-query-contractcode)接口查询获取。 |

接入免密支付时需注意以下事项：

1.  不允许多个应用共同使用同一个免密代扣模板，发布的商品必须和免密代扣模板是一对一的关系。
    
2.  同一用户在同一商户的同一模板下多次签约，需使用新的商户签约协议号，华为支付侧委托代扣协议ID不变并关联新的商户签约协议号，历史关联的商户签约协议号自动失效。
    
3.  商户在多个应用中使用同一委托代扣协议ID发起免密代扣时，需要统一传递用户签约的应用ID。