Submit Bank Account Material Supplement
Submit additional KYC or compliance documents for an existing linked OTC bank account when GatePay requests a material supplement.
Overview
This page documents thePOST /withdraw/open/institution/otc/api/bank/material/supplement endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.
Use this API when GatePay or compliance requests extra documents for a bank account that is already linked for that sub-account. It does not replace Create Bank Account; it only uploads supplementary files for an existing bankAccountId obtained under the same institution flow.
Notes
- Authentication uses the standard GatePay signed headers plus institutional requirements (including
X-GatePay-On-Behalf-Ofwhere applicable). See /global/api-reference/version/100/en/common/institutionalCommonHeaders. - Limits: At most 5 files per non-empty list; each file must be non-empty and 4 MB or smaller; allowed filename extensions:
jpg,jpeg,png,pdf. - Response: Indicates whether the supplementary materials have been accepted for processing. The final review outcome is still determined by the account status in Query Bank Account List.
Headers
Required delegated-subject header. Provide the initiating account ID for this request. For institution merchant APIs, this is typically the target sub-account ID; for institution charge and transfer APIs, it can be either an institution account ID or a sub-account ID.
Body
Supplementary document upload for a linked bank account. See each property for the material type; bankAccountId targets the account.
Shareholder register or ownership documentation.
1 - 5 elementsShareholding / beneficial ownership structure chart.
1 - 5 elementsResponse
Success

