跳转到主要内容
POST
/
webhook
/
institution
/
v1
/
accounts
/
callback
curl --request POST \
  --url https://openplatform.gateapi.io/webhook/institution/v1/accounts/callback \
  --header 'Content-Type: application/json' \
  --header 'X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>' \
  --data '
{
  "bizType": "INSTITUTION",
  "bizId": "35778162074976257",
  "bizStatus": "INSTITUTION_ACCOUNT_SUCCESS",
  "clientId": "ktBVqBBHrEHJmfZH",
  "data": "{\"request_id\":\"35778162074976257\",\"account_id\":\"2124543768\",\"customer_id\":\"1234\",\"display_name\":\"my test\",\"status\":\"ACTIVE\",\"created\":1764139242707}"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.gate.com/llms.txt

Use this file to discover all available pages before exploring further.

​
概述

本页说明 POST /webhook/institution/v1/accounts/callback。完整的参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。 创建子账户成功或失败时，GatePay 会向商户在后台配置的回调地址发送通知。商户应在该地址接收并解析消息，并返回 HTTP 200 表示已成功接收。

​
说明

​
创建子账户通知字段

字段名类型说明
bizTypestring描述通知类别， INSTITUTION-创建子账户
bizIdstring创建申请单号
bizStatusstring业务状态 INSTITUTION_ACCOUNT_SUCCESS-创建成功 INSTITUTION_ACCOUNT_FAIL-创建失败
client_idstring创建子账户的商户client_id
datacontent消息内容，JSON 字符串

​
data 解析后内容

字段名类型说明
request_idstring创建申请单号
account_idstring子账户 ID
customer_idstring平台侧客户 ID
display_namestring展示名
statusstring账户状态 已创建-ACTIVE 创建失败-FAIL
createdint64创建时间（毫秒）

​
示例

创建子账户成功通知： 
{
  "bizType": "INSTITUTION",
  "bizId": "35778162074976257",
  "bizStatus": "INSTITUTION_ACCOUNT_SUCCESS",
  "clientId": "ktBVqBBHrEHJmfZH",
  "data": "{\"request_id\":\"35778162074976257\",\"account_id\":\"2124543768\",\"customer_id\":\"1234\",\"display_name\":\"my test\",\"status\":\"ACTIVE\",\"created\":1764139242707}"
}
data 解析后内容： 
{
  "request_id": "35778162074976257",
  "account_id": "2124543768",
  "customer_id": "1234",
  "display_name": "my test",
  "status": "ACTIVE",
  "created": 1764139242707
}

请求头

​
X-GatePay-On-Behalf-Of
string
必填

必填代理归属请求头。请填写本次交易的发起方账户 ID，可填写机构账户 ID 或子账户 ID。

请求体

application/json

创建子账户结果回调通知体

​
bizType
string

描述通知类别，INSTITUTION-创建子账户

​
bizId
string

创建申请单号

​
bizStatus
string

业务状态 INSTITUTION_ACCOUNT_SUCCESS-创建成功 INSTITUTION_ACCOUNT_FAIL-创建失败

​
clientId
string

创建子账户的商户 client_id

​
data
string

消息内容，JSON 字符串，解析后参见 CreateSubAccountCallbackData

响应

200

接收成功，商户需返回 HTTP 200