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

Request

Base URL
https://openplatform.gateapi.io
URL
https://openplatform.gateapi.io/merchant/open/institution/v1/accounts/create
Auth
none declared. Required headers: X-GatePay-Certificate-ClientId, X-GatePay-Timestamp, X-GatePay-Nonce, X-GatePay-Signature

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

Millisecond timestamp; the difference from server time must not exceed 30 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_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.

Success

statusstring

codestring

errorMessagestring

{
  "status": "SUCCESS",
  "code": "000000"
}