GAgate

Update Sub-Account

Changed on

Update sub-account details and account holder information.

post/merchant/open/institution/v1/accounts/update

Request

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

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

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.

X-GatePay-On-Behalf-Ofstring required

Required delegated subject header. Provide the initiating account ID for this transaction. It can be an institution account ID or a sub-account ID.

Request body

display_namestring

Display name of the sub-account.

metadataobject

Additional key–value metadata.

Response

Success

statusstring
codestring
errorMessagestring

Changes

  • 62d31c7e909aRevision changes
    • warning

      added the new ACTIVE enum value to the / response property for the response status

    • warning

      added the new FAIL enum value to the / response property for the response status

    • warning

      added the new INIT enum value to the / response property for the response status

    • warning

      added the new NONE enum value to the / response property for the response status

    • warning

      added the new PENDING enum value to the / response property for the response status

    • warning

      added the new RISK_SUSPEND enum value to the / response property for the response status