跳转到主要内容
WEBHOOK
otcCallbackWebhook
{
  "bizType": "OTC",
  "bizId": "71347515709194240",
  "bizStatus": "RECHARGE_SUCCESS",
  "clientId": "merchant_client_id",
  "data": "{\"orderId\":\"71347515709194240\",\"clientOrderId\":\"merchant_order_20260413001\",\"fiatRate\":\"1.005\",\"type\":\"BUY\",\"fiatCurrency\":\"USD\",\"fiatAmount\":\"100.00\",\"cryptoCurrency\":\"USDT\",\"cryptoAmount\":\"99.50\",\"updateTime\":\"1712989200\"}"
}

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 otcCallbackWebhook。完整的参数、响应结构与示例由上方关联的 OpenAPI 或 webhook 定义渲染。 用于接收 OTC 入金与出金订单状态变更通知。

​
说明

  • 在信任回调内容前，务必先完成签名校验。
  • 只有在消息已被后端成功接收后再返回 HTTP 200。
  • 建议基于 bizId 或 clientOrderId 做幂等处理。
  • 出金回调的 data 字段中可能包含 bankSlipInfo，用于表示银行水单或回单信息。
  • 如果下游系统暂时不可用，建议先落库保存回调，再异步重试处理。
  • 如需结合业务流程理解 OTC 状态推进，请同时参见 OTC Guide 页面。

请求体

application/json
​
bizType
string
必填

固定的 OTC 业务类型。

​
bizId
string
必填

OTC 订单 ID。

​
bizStatus
enum<string>
必填

OTC 回调业务状态。

可用选项:
RECHARGE_SUCCESS,
RECHARGE_FAIL,
WITHDRAW_SUCCESS,
WITHDRAW_FAIL,
WITHDRAW_DISPATCHED
​
data
string
必填

包含订单快照的 JSON 字符串，通常包括 orderId、clientOrderId、fiatRate、type、fiatCurrency、fiatAmount、cryptoCurrency、cryptoAmount、updateTime 等字段；出金回调中还可能包含 tradeFee、finalFiatAmount、bankSlipInfo 等字段。

示例:

"{\"orderId\":\"2016768770965639168\",\"clientOrderId\":\"7490324045\",\"fiatRate\":\"0.9981\",\"type\":\"SELL\",\"fiatCurrency\":\"USD\",\"fiatAmount\":\"9800\",\"cryptoCurrency\":\"USDT\",\"cryptoAmount\":\"10000\",\"updateTime\":\"1769670300606\",\"tradeFee\":\"10.00\",\"finalFiatAmount\":\"9790.00\",\"bankSlipInfo\":\"bank_receipt_20260418.pdf\"}"

​
clientId
string

商户 clientId。

​
client_id
string

部分集成中使用的备用商户 clientId 字段。

响应

200

商户成功接收回调后返回 HTTP 200。