跳转到主要内容
WEBHOOK
withdrawWebhook
{
  "main_order": {
    "batch_id": "831618381568",
    "merchant_id": 17329983,
    "status": "SUCCESS",
    "client_id": "igasgasdbub",
    "pay_back_status": "NO",
    "channel_id": ""
  },
  "suborders": [
    {
      "merchant_id": 130559,
      "channel_id": "",
      "suborder_id": "30969031299072",
      "chain": "TRX",
      "address": "QBTW9qTMQBTW9qnoeMMmUxaAWEqVDDUgUw",
      "currency": "USDT",
      "amount": 2362.1,
      "fee": 1,
      "tx_id": "aaa33e642d6fb6e3272ae3c21c60f1248d1cd7ccdc000458308d690699",
      "memo": "",
      "status": "DONE",
      "merchant_withdraw_id": "1839295815",
      "fee_type": 1,
      "batch_withdraw_id": "",
      "desc": "",
      "reconciliation_status": 0,
      "is_placed": 1,
      "finish_time": 1748581414000,
      "sub_amount": 2363.1,
      "done_amount": 2362.1
    }
  ]
}

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 withdrawWebhook。完整的参数、响应结构与示例由上方关联的 OpenAPI 或 webhook 定义渲染。 当批量提现订单状态发生变化时，GatePay 会向商户配置的回调地址发送异步通知。回调载荷通常包含主单对象与子单列表，用于表示整批任务的总体状态及每笔子订单的处理结果。

​
说明

  • 该页描述的是 GatePay 主动投递的回调载荷，不是商户主动发起的请求。
  • 收到回调后请先完成签名校验，再进行幂等处理与业务更新。
  • 建议以 batch_id 与业务侧唯一标识组合实现幂等，避免重复更新状态。
  • 如需按业务场景理解字段含义，请结合 Guide 中的 通知 与 出金 一并阅读。
  • 通用签名规则请参见 /api-reference/version/100/cn/common/securityAndSignature。

响应

200 - application/json

返回 HTTP 200 表示已收到回调通知。

GatePay 在批量提现订单状态变化时向商户回调的数据结构，包含主订单对象和子订单数组。

​
main_order
object
必填

回调通知中的主提现单信息。

​
suborders
object[]
必填

子订单回调详情数组。