跳转到主要内容
WEBHOOK
unresolvedPayNotify
{
  "bizType": "PAY_UNRESOLVED",
  "bizId": "100916",
  "bizStatus": "UNRESOLVED_PENDING",
  "data": {
    "hash": "0x76a445961ae0e6fea1197a73b59494ec4939f178639ae0683f6949a57f47fbc0",
    "errorType": "fix_error_currency",
    "orderType": "payee_type",
    "toAddress": "0x49D24D32b9ed2fc9e7AEd8a08976615988db4f6A",
    "updateTime": 1780036391365,
    "actualChain": "ARBEVM",
    "exceptionId": "100916",
    "fromAddress": "0x144Ff55c1a8C80C893b6272a87C228fc601E4de4",
    "actualAmount": "0.12",
    "customerName": "channelId2293698068",
    "actualCurrency": "USDC",
    "originalOrderId": "",
    "expectedChainCurrency": [
      {
        "chain": "MATIC",
        "currencies": [
          "USDT"
        ]
      }
    ]
  }
}
{
  "returnCode": "SUCCESS",
  "returnMessage": ""
}

​
概述

本页说明 webhook unresolvedPayNotify。完整的参数、响应结构与示例由上方关联的 OpenAPI 或 webhook 定义渲染。

​
说明

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

请求体

application/json

异常支付回调通知结构

​
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

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