---
title: "Sub-account Creation Result Notification"
method: POST
path: "institutionAccountWebhook"
---

# Sub-account Creation Result Notification

`POST institutionAccountWebhook` (webhook)

When sub-account creation succeeds or fails, GatePay sends an asynchronous POST notification to the callback URL configured by the merchant.

The callback payload includes `bizType`, `bizId`, `bizStatus`, `clientId`, and `data`, where `data` is a JSON string of the sub-account creation result object. The merchant must accept and parse the notification at that URL and return HTTP 200 to acknowledge receipt.

## Payload

- CreateSubAccountCallbackNotification — Callback notification body for sub-account creation result
  - `bizType` string, required — Notification type; INSTITUTION = sub-account creation
  - `bizId` string, required — Creation request ID
  - `bizStatus` string, required — Business status: INSTITUTION_ACCOUNT_SUCCESS = created, INSTITUTION_ACCOUNT_FAIL = creation failed
  - `clientId` string, required — Merchant client_id that created the sub-account
  - `data` string, required — Message body as a JSON string; parsed structure see `CreateSubAccountCallbackData`.

## Acknowledgement `200`

Return HTTP 200 to indicate the callback notification has been received.

- CreateSubAccountCallbackAck — Merchant acknowledgement returned after receiving the callback.
  - `returnCode` string, required — Return status code, for example `SUCCESS`.
  - `returnMessage` string, nullable — Return message.

---

[API](https://skmtc.dev/gate/apis/gatepay-institutional-api.md) · [All operations](https://skmtc.dev/gate/apis/gatepay-institutional-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gate/gatepay-institutional-api/revisions/b83b60d86dc6/schema)