v1

latestOpenAPI 3.1.0MIT2026-07-211097127.9 KB

Sub-account Verification Result Notification

When sub-account KYB verification completes (passed or rejected), 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 verification result object. The merchant must accept and parse the notification at that URL and return HTTP 200 to acknowledge receipt.

postWebhookinstitutionVerifyResultWebhook

Payload

bizTypestring required

Notification type; INSTITUTION = institution notification

bizIdstring required

Notification business ID

bizStatusstring required

Business status: PASSED = verification passed, FAILED = verification rejected

clientIdstring required

Institution merchant client_id

datastring required

Message content as a JSON string; see InstitutionVerifyResultCallbackData after parsing.

Response

Return HTTP 200 to acknowledge receipt.

returnCodestring required

Return status code, for example SUCCESS.

returnMessagestring nullable

Return message.