跳转到主要内容
WEBHOOK
unresolvedPayWebhook
{
  "bizType": "PAY_UNRESOLVED",
  "bizId": "123",
  "bizStatus": "UNRESOLVED_PENDING",
  "data": {
    "exceptionId": "123",
    "orderType": "acquiring_type",
    "errorType": "address_risk_address",
    "originalOrderId": "355450733498011648",
    "expectedAmount": "10.0",
    "expectedChainCurrency": [
      {
        "chain": "TRX",
        "currencies": [
          "USDT"
        ]
      }
    ],
    "actualAmount": "1.0",
    "actualCurrency": "USDT",
    "actualChain": "TRX",
    "customerName": "",
    "toAddress": "TExampleAddressxxxxxxxxxxxxxxxxxx",
    "fromAddress": "TFromAddressxxxxxxxxxxxxxxxxxxxx",
    "hash": "0xabc",
    "updateTime": 1740000000000
  }
}
{
  "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 unresolvedPayWebhook。完整的参数、响应结构与示例由上方关联的 OpenAPI 或 webhook 定义渲染。

说明

  • 该页描述的是 GatePay 主动投递的回调载荷,不是商户主动发起的请求。
  • 收到回调后请先完成签名校验,再进行幂等处理与业务更新。
  • 如需查看按业务场景拆分的回调说明,请结合 Guide 中的通知章节一并阅读。
  • 通用签名规则请参见 /api-reference/version/100/cn/common/securityAndSignature

请求体

application/json

异常支付回调通知结构(POST)

bizType
enum<string>

业务类型,固定为 PAY_UNRESOLVED

可用选项:
PAY_UNRESOLVED
bizId
string

业务 ID(如异常单关联标识,以实际返回为准)。

bizStatus
enum<string>

业务状态,例如 UNRESOLVED_PENDING(待处理,以实际返回为准)。

可用选项:
UNRESOLVED_PENDING
data
object

异常支付明细。部分字段在收单 / 收款码场景下可能为空,见各字段说明。

响应

200 - application/json

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

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

returnCode
string
必填

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

returnMessage
string | null

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