跳转到主要内容
WEBHOOK
batchTransferNotify
{
  "bizType": "PAY_BATCH",
  "bizId": "79553020665790540",
  "bizStatus": "PAID",
  "data": "{\"batchItemList\":[{\"amount\":\"0.12300000\",\"channel_id\":\"\",\"create_time\":1780017207390,\"currency\":\"USDT\",\"receiver_id\":22112573,\"status\":\"PAID\"}],\"merchant_batch_no\":\"K4t1ijqX1LYRYmlp\"}"
}
{
  "returnCode": "SUCCESS",
  "returnMessage": ""
}

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.

​
概述

本页说明 webhook batchTransferNotify。完整的参数、响应结构与示例由上方关联的 OpenAPI 或 webhook 定义渲染。 批量转账订单状态变更时，GatePay 向商户配置的 callback URL 发送异步通知（bizType 为 PAY_BATCH）。

​
说明

  • 建议基于 merchant_batch_no 或 bizId 做幂等处理。
  • 验签、重试、data 解析与成功应答见 通知概览；签名规则见 安全与签名。

​
触发情形

  • 批量转账订单状态发生改变时，GatePay 向商户注册时配置的 callback URL 发送通知
  • 若通知投递失败，重试规则见 通知概览。
适用范围：批量转账 / 批量奖励类订单（bizType 为 PAY_BATCH）。

​
消息结构

字段名类型说明
bizTypestring固定为 PAY_BATCH
bizIdstring批量订单 ID（可能为空字符串，以实际为准）
bizStatusstring批量订单状态，见下表
client_idstring创建订单的商户 client_id
datastring业务数据 JSON 字符串

​
消息结构示例

{
  "bizType": "PAY_BATCH",
  "bizId": "79553020665790540",
  "bizStatus": "PAID",
  "data": "{\"batchItemList\":[{\"amount\":\"0.12300000\",\"channel_id\":\"\",\"create_time\":1780017207390,\"currency\":\"USDT\",\"receiver_id\":22112573,\"status\":\"PAID\"}],\"merchant_batch_no\":\"K4t1ijqX1LYRYmlp\"}"
}

​
bizStatus 枚举值

值说明
PAID批量转账/奖励订单处理完成

​
data 字段说明

字段名类型说明
merchant_batch_nostring商户批量单号
batchItemListarray批量转账子项列表

​
batchItemList 子项字段

字段名类型说明
amountstring子项金额
channel_idstring客户名称 / 渠道标识
create_timeint64创建时间（毫秒）
currencystring币种
receiver_idint64接收方 UID
statusstring子项状态，例如 PAID

​
回调示例

​
批量转账完成（bizStatus=PAID）

{
  "bizType": "PAY_BATCH",
  "bizId": "79553020665790540",
  "bizStatus": "PAID",
  "data": "{\"batchItemList\":[{\"amount\":\"0.12300000\",\"channel_id\":\"\",\"create_time\":1780017207390,\"currency\":\"USDT\",\"receiver_id\":22112573,\"status\":\"PAID\"}],\"merchant_batch_no\":\"K4t1ijqX1LYRYmlp\"}"
}

请求体

application/json
​
bizType
enum<string>
必填

业务类型，固定为 PAY_BATCH。

可用选项:
PAY_BATCH
​
bizId
string
必填

批量订单 ID。

​
bizStatus
enum<string>
必填

批量订单状态，常见为 PAID（转账/奖励完成）。

可用选项:
PAID
​
data
string
必填

业务数据 JSON 字符串，解析后结构见 batchTransferData。

​
client_id
string

创建订单的商户 client_id。

​
batchTransferData
object

data 解析后的批量转账明细。

​
description
any

响应

200 - application/json

返回 HTTP 200 表示商户已成功接收通知。

商户接收通知后的响应体。

​
returnCode
string
必填

返回状态码，SUCCESS 表示成功。

​
returnMessage
string | null

返回说明，成功时可为空。