GAgate

Create Bank Account

Create a linked bank account for OTC settlement.

post/withdraw/open/otc/api/bank/create

Request

  • Base URL
    https://openplatform.gateapi.io
  • URL
    https://openplatform.gateapi.io/withdraw/open/otc/api/bank/create
  • Auth
    none declared. Required headers: X-GatePay-Certificate-ClientId, X-GatePay-Signature, X-GatePay-Timestamp, X-GatePay-Nonce

Headers

X-GatePay-Certificate-ClientIdstring required

Merchant application client ID used to identify the calling app.

X-GatePay-Signaturestring required

HMAC signature generated from the request according to GatePay signing rules.

X-GatePay-Timestampstring required

Millisecond timestamp; the difference from server time must not exceed 30 seconds.

X-GatePay-Noncestring required

Random nonce used together with the timestamp to prevent replay attacks.

Request body multipart/form-data

bankAccountNamestring required

Bank account name.

bankNamestring required

Bank name.

countryIdinteger required

Country ID.

addressstring required

Bank address.

ibanstring required

Account number or IBAN.

swiftstring required

SWIFT.

remittanceLineNumberstring

Routing or clearing code.

agentBankNamestring

Agent bank name.

agentBankSwiftstring

Agent bank SWIFT.

filestring binary required

Bank statement file. The file must not exceed 4 MB and only jpg, jpeg, and png formats are accepted. Upload a bank statement issued within the last 3 months. The bank account name must exactly match the verified identity name. If there is any difference due to language or similar reasons, also provide supporting documents such as a bank certification letter, passport, or an official name-change receipt.

Response

Success

codestring

Business response code.

statusstring

Top-level request status.

errorMessagestring

Error message returned when the request fails.

Example response

{
  "code": "000000",
  "data": {
    "bankAccountId": "2897434",
    "needSupplementMaterial": false
  },
  "status": "SUCCESS",
  "errorMessage": ""
}

Changes

No recorded changes to this operation across all 5 revisions of this API.