跳转到主要内容
WEBHOOK
subscriptionOrderPaymentNotifyWebhook
{
  "bizId": "82285766622838905",
  "bizStatus": "DEDUCT_SUCCESS",
  "bizType": "SUBSCRIPTION_PAYMENT",
  "data": {
    "chain": "ARBEVM",
    "cryptoAmount": "0.01",
    "cryptoCurrency": "USDT",
    "merchantId": "1627288",
    "merchantSubscriptionOrderNo": "7425377837",
    "payStatus": "SUCCESS",
    "payTime": 1774953356703,
    "paymentChannel": "WEB3",
    "paymentOrderNo": "82285766622838906",
    "planNo": "82285766622838796",
    "subscriptionOrderNo": "82285766622838905",
    "txHash": "0x599d93b492bfbbde9aed35a6fa40ee0499b4c64506a3f0c93adfcd55",
    "userAddress": "0x20C58Cdf4106D8c60c5163C47B7A5D91C91f"
  }
}
{
  "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 subscriptionOrderPaymentNotifyWebhook。完整的参数、响应结构与示例由上方关联的 OpenAPI 或 webhook 定义渲染。

​
说明

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

请求体

application/json

订阅扣款通知入参 POST方式

​
bizType
string

业务类型：SUBSCRIPTION_PAYMENT 订阅支付扣款通知；ACCOUNT_AUTH_DEDUCTION 授权支付扣款通知。

​
bizStatus
string

业务状态：DEDUCT_SUCCESS 扣款成功；DEDUCT_FAILED 扣款失败。

​
data
object

响应

200 - application/json

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

​
returnCode
string

响应码，SUCCESS表示成功 FAIL标识失败

​
returnMessage
string

响应描述，成功时为空