跳转到主要内容
POST
/
webhook
/
institution
/
v1
/
accounts
/
callback
curl --request POST \
  --url https://openplatform.gateapi.io/webhook/institution/v1/accounts/callback \
  --header 'Content-Type: application/json' \
  --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}"
}
'
创建子账户成功或失败时，GatePay 会向商户在后台配置的回调地址发起 POST 请求，推送以下通知体。商户需在该地址上接收并解析，并返回 HTTP 200 表示接收成功。 创建子账户成功通知:
字段名类型说明
bizTypestring描述通知类别， INSTITUTION-创建子账户
bizIdstring创建申请单号
bizStatusstring业务状态 INSTITUTION_ACCOUNT_SUCCESS-创建成功 INSTITUTION_ACCOUNT_FAIL-创建失败
client_idstring创建子账户的商户client_id
datacontent消息内容，json字符串
content
字段名类型说明
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}"
}
消息内容: 
{
  "request_id": "35778162074976257",
  "account_id": "2124543768",
  "customer_id": "1234",
  "display_name": "my test",
  "status": "ACTIVE",
  "created": 1764139242707
}

请求体

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