v1

latestOpenAPI 3.1.0MIT2026-07-211097127.9 KB

Create Sub-Account

Create a new sub-account for a customer under the institution account and register the account holder information.

post/merchant/open/institution/v1/accounts/create

Headers

X-GatePay-Certificate-ClientIdstring required
Example:4186d0c6-6a35-55a9-8dc6-5312769dbff8

The clientId assigned when the merchant registers an application in the Gate merchant console.

X-GatePay-Timestampstring required
Example:1672905655498

UTC timestamp in milliseconds when the request is generated. GatePay will not process requests where the difference from the receive time exceeds 10 seconds.

X-GatePay-Noncestring required
Example:9578

Random string. Must comply with HTTP header rules; recommended length is within 32 characters, composed of digits and letters.

X-GatePay-Signaturestring required

Request signature. GatePay uses this signature to verify whether the request is valid.

Request body

request_idstring required

Unique request ID from caller.

customer_idstring required

Customer ID on the platform side.

display_namestring required

Display name of the sub-account.

metadataobject

Additional key–value metadata.

Response

Success

statusstring
codestring
errorMessagestring

Example response

{
  "status": "SUCCESS",
  "code": "000000"
}
All 12 operations