营销补贴商户白名单报备

接口说明

1. 用于商户营销补贴的出款白名单一次性报备。报备成功后，商户收款账户才具备收取代付补贴款的资格；
2. 报备一次长期有效，无需每次补贴发放前重复调用；
3. 平台侧记录报备状态防重：已报备的商户重复调用直接返回成功，不会重复报备至渠道；
4. 附件需先调用【1.1 图片上传】/【1.2 文件上传】取得钱账通文件编号(file_no)，平台内部将文件转报至渠道，商户无需自行上传渠道；
5. 报备前若商户收款账户号未生成，接口内部会自动先取号再报备；
6. 调用方需保证会员已配置营销账户，且上送的渠道商户号与营销账户匹配。

请求参数说明

service : market.subsidy.merchant.whitelist

params :

attachments 取值说明(JSON 数组字符串，支持两种元素形态):

• 纯文件编号数组（附件类型默认 OTHERS）：
  ["2001","2002"]
• 含类型的对象数组：
  [{"file_no":"2001","att_type":"ID_CARD_FRONT"},{"file_no":"2002","att_type":"BANK_CARD"}]

att_type 取开放平台附件类型枚举：ID_CARD_FRONT(身份证人像面)/ID_CARD_BEHIND(身份证国徽面)/BANK_CARD(银行卡)/BUSINESS_LICENCE(营业执照)/MERCHANT_PHOTO(商户照片)/SHOPINNER(店内照)/XY(协议)/NETWORK_XY(网签协议)/OTHERS(其他) 等。

响应参数说明

response 解析后的结果：

请求示例

{
    "service": "market.subsidy.merchant.whitelist",
    "params": {
        "member_no": "8886888800000000001",
        "channel_merchant_no": "82229000012345",
        "attachments": "[{\"file_no\":\"2001\",\"att_type\":\"ID_CARD_FRONT\"},{\"file_no\":\"2002\",\"att_type\":\"BANK_CARD\"}]"
    }
}

响应示例

{
    "status": "OK",
    "result": "白名单报备成功"
}

已报备商户重复调用：

{
    "status": "OK",
    "result": "白名单已报备，无需重复报备"
}

注意事项

1. 本接口为一次性报备，报备成功后长期有效；重复调用已报备商户直接返回成功；
2. 附件 file_no 必须已通过【1.1 图片上传】/【1.2 文件上传】上传成功，否则报错”附件文件不存在”；
3. 报备仅使商户收款账户具备收代付款资格，与每次补贴申请流程无关；
4. 常见错误：营销账户记录不存在 / 渠道商户号与营销账户不匹配 / 附件文件编号列表不能为空 / 附件上传失败 / 补贴目标会员分账核心账户不存在。