> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 提交银行账户补充材料

> 当 GatePay 要求对已有 OTC 绑定银行卡补充 KYC 或合规材料时（例如绑卡审核后或账户待补充证明），通过本接口提交补充文件。

## 概述

本页说明 `POST /withdraw/open/otc/api/bank/material/supplement` 接口。完整的请求参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。

## 说明

* 鉴权使用 GatePay 标准签名请求头。
* 本页为普通商户 OTC 路径说明。
* 该接口用于在平台要求补充材料时，为已绑定银行账户补交认证或合规文件。
* 签名与验签规则见 [/api-reference/version/100/cn/common/securityAndSignature](/api-reference/version/100/cn/common/securityAndSignature)。
* **限制：** 每个非空列表内最多 **5** 个文件；单文件须非空且不超过 **4 MB**；原始文件名后缀须为 `jpg`、`jpeg`、`png`、`pdf` 之一。


## OpenAPI

````yaml api-reference/version/100/cn/openapi/otc-fiat-openapi.json POST /withdraw/open/otc/api/bank/material/supplement
openapi: 3.1.0
info:
  title: GatePay OTC 法币 API
  description: OTC 法币出金与入金 API 参考。
  version: 2.1.0
servers:
  - url: https://openplatform.gateapi.io
security: []
paths:
  /withdraw/open/otc/api/bank/material/supplement:
    post:
      summary: 提交银行账户补充材料
      description: 当 GatePay 要求对已有 OTC 绑定银行卡补充 KYC 或合规材料时（例如绑卡审核后或账户待补充证明），通过本接口提交补充文件。
      parameters:
        - $ref: '#/components/parameters/X-GatePay-Certificate-ClientId'
        - $ref: '#/components/parameters/X-GatePay-Signature'
        - $ref: '#/components/parameters/X-GatePay-Timestamp'
        - $ref: '#/components/parameters/X-GatePay-Nonce'
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/OtcBankMaterialSupplementRequest'
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankMaterialSupplementResponse'
components:
  parameters:
    X-GatePay-Certificate-ClientId:
      name: X-GatePay-Certificate-ClientId
      in: header
      required: true
      schema:
        type: string
      description: 用于标识调用应用的商户应用 ClientId。
    X-GatePay-Signature:
      name: X-GatePay-Signature
      in: header
      required: true
      schema:
        type: string
      description: 按 GatePay 签名规则生成的 HMAC 签名。
    X-GatePay-Timestamp:
      name: X-GatePay-Timestamp
      in: header
      required: true
      schema:
        type: string
      description: 用于防重放和验签的 Unix 时间戳。
    X-GatePay-Nonce:
      name: X-GatePay-Nonce
      in: header
      required: true
      schema:
        type: string
      description: 与时间戳配合使用的随机串，用于防止重放攻击。
  schemas:
    OtcBankMaterialSupplementRequest:
      type: object
      description: 针对已绑定银行账户的补充材料上传；各文件类别含义见对应属性说明。`bankAccountId` 为待补件的目标账户。
      properties:
        bankAccountId:
          type: string
          description: 目标银行账户 ID（与「查询银行账户列表」或「创建银行账户」返回的 `bankAccountId` 一致）。
        certificate:
          type: array
          minItems: 1
          maxItems: 5
          description: 公司注册证书、营业执照或同等企业身份证明类材料。
          items:
            type: string
            format: binary
        passport:
          type: array
          minItems: 1
          maxItems: 5
          description: 护照或其他政府签发的身份证明。
          items:
            type: string
            format: binary
        shareHolders:
          type: array
          minItems: 1
          maxItems: 5
          description: 股东名册或股权相关证明。
          items:
            type: string
            format: binary
        shareHoldingStructure:
          type: array
          minItems: 1
          maxItems: 5
          description: 股权结构图或受益所有人结构说明。
          items:
            type: string
            format: binary
        additional:
          type: array
          maxItems: 5
          description: 补充通知中明确要求提供的其他材料。
          items:
            type: string
            format: binary
      required:
        - bankAccountId
        - certificate
        - passport
        - shareHolders
        - shareHoldingStructure
    BankMaterialSupplementResponse:
      type: object
      properties:
        code:
          type: string
          description: 业务响应码。
        status:
          type: string
          description: 顶层请求状态。
        errorMessage:
          type: string
          description: 请求失败时的错误信息。
        data:
          type: boolean
          description: 为 `true` 表示补充材料已被受理进入处理。最终审核结果仍以「查询银行账户列表」返回的账户状态为准。

````