帮助中心
Gate Pay
商家接入说明

Gate Pay 回调解读 | Gate

2026-06-18 (UTC+8)
38,509 阅读量
3

Gate Pay 回调通知API文档:https://docs.gate.com/api-reference/version/100/cn/common/asyncNotification

1

支付回调信息状态解读

动态地址类

1.动态地址支付资金到账通知(biztype = TRANSFER_ADDRESS)

TRANSFERRED_ADDRESS_IN_TERM:订单有效期内即时到账。
TRANSFERRED_ADDRESS_DELAY:超过有效期的支付到账,将实际支付对应金额充值到商户余额账户中(超过有效期即时到账)。

2.动态地址支付订单状态变更通知(biztype = PAY_ADDRESS)

PAY_SUCCESS:支付成功。
PAY_CLOSE:订单过期。
PAY_EXPIRED_IN_PROCESS:等待链上确认资金。

静态地址类

1.静态地址收款成功(biztype=PAY_FIXED_ADDRESS)

PAY_SUCCESS:支付成功,且到账

2.静态地址被判定为风险地址(biztype=FIXED_ADDRESS_RISK)

RISK_ADDRESS:静态地址被标记为风险地址

异常地址支付支付类

每产生一笔异常支付流水,Gate Pay 会向对应商户发送一次 webhook 通知。
该类型支付 bizType 固定为 PAY_UNRESOLVED。
客户需要根据data里的 errorType 判断账单问题,并参照 Gate Pay 异常支付处理指引 处理或联系 Gate Pay 客户经理。

  • address_risk_address
    — 动态地址高危地址
  • address_error_currency
    — 动态地址错误的币种
  • address_error_chain
    — 动态地址错误的区块链网络
  • fix_error_currency
    — 固定地址错误的币种
  • fix_error_chain
    — 固定地址错误的区块链网络
  • fix_risk_address
    — 固定地址高危地址
  • fix_delete
    — 固定地址删除
  • fix_partial_delete
    — 固定地址部分删除

关于动态地址支付的回调信息

为什么支付回调信息有两种?

1.资金到账通知(TRANSFER_ADDRESS):实际到账金额的通知。
2.订单状态变更通知(PAY_ADDRESS):订单状态的变更通知。

商户需要结合这两类信息判断订单是否成功,以便执行发货或处理失败订单。

回调信息发送时间点

1.资金到账通知 链上确认支付成功后,为商户实时入账资金,同时回调给商户。
2.订单状态变更通知 订单状态发生变化时触发。

动态地址支付的支付场景及订单状态判断

1.有效期内一次性足额或超额支付

描述: 在订单有效期内,只要足额或者超额支付,待链上确认资金后,就会实时发送回调信息。
订单状态 :首先等待链上确认资金,回调一个中间态:bizStatus 为 PAY_EXPIRED_IN_PROCESS。等待链上确认资金后,订单成功,回调bizStatus 为 PAY_SUCCESS,到账金额为doneAmountOnChain
资金到账通知 :bizStatus 为 TRANSFERRED_ADDRESS_IN_TERM,到账金额为 transferAmount。

2.有效期内未足额支付

描述 :用户在订单有效期内支付不足订单金额的,待链上确认资金后,给商户入账用户实际支付的金额,并实时发送资金到账的回调信息。
订单状态 :有效期内,此时订单状态没有发生变化,不发送订单状态的回调信息
资金到账通知 :bizStatus 为 TRANSFERRED_ADDRESS_IN_TERM,到账金额为 transferAmount。

3.有效期内未足额支付,且未补足
描述 :用户在订单有效期内支付不足订单金额,且在有效期内没有补足。
订单状态 :订单有效期结束的时候,发送订单状态的回调。bizStatus为PAY_CLOSE,到账金额为doneAmountOnChain。
资金到账通知 :用户支付完成后,已经实时回调,不再重复发送。

4.有效期内未足额支付,但已补足

4.1 有效期内补足金额:
用户补足剩余金额后 :
订单状态 :此时等待链上确认资金,回调一个中间态:bizStatus 为 PAY_EXPIRED_IN_PROCESS。
资金到账通知 :等待链上确认补足的资金,所以不发送资金到账通知。
链上确认成功后 :
订单状态 :等链上资金确认完毕,金额足够,此时订单才算成功,bizStatus 为 PAY_SUCCESS,到账金额为doneAmountOnChain (此时为所有支付的汇总金额)。
资金到账通知 :bizStatus 为 TRANSFERRED_ADDRESS_IN_TERM,到账金额为 transferAmount。
4.2 有效期外补足金额:
订单状态 :因检测到有效期内没有足额支付,在订单有效期结束的时候,会先发送订单状态的回调。bizStatus为PAY_CLOSE,到账金额为doneAmountOnChain。
资金到账通知 :用户支付完成后,已经实时回调,不再重复发送。
用户有效期外补足剩余金额后 :会发送资金到账的回调,bizStatus 为 TRANSFERRED_ADDRESS_DELAY,到账金额为 transferAmount。 (此种情况下不会额外发送订单状态的回调,最终回调信息中不包含 doneAmountOnChain 字段。如用户使用多笔交易完成支付,商户需自行累加所有回调中的 transferAmount 以确认最终到账总额。)

5.过期支付

描述 :用户在订单有效期外支付,不管是部分还是足额,亦或是超额支付,链上确认成功后,会实时到账。
订单状态变 :因为有效期内没有支付任何金额,在订单有效期结束的时候,会回调bizStatus 为 PAY_CLOSE。
资金到账 :无资金到账通知。
过期后支付: 过期后支付一笔,回调一笔资金到账的通知,bizStatus 为 TRANSFERRED_ADDRESS_DELAY,到账金额为 transferAmount。 (此种情况下不会额外发送订单状态的回调,最终回调信息中不包含 doneAmountOnChain 字段。如用户使用多笔交易完成支付,商户需自行累加所有回调中的 transferAmount 以确认最终到账总额。)
商户需要根据 订单状态 和 资金到账 两条回调信息判断订单是否成功。

6.动态地址支付异常订单回调信息

6.1 支付了与订单不一致的币种或区块链网络
商户户将收到 Biztype=PAY_UNRESOLVED ;
且 data.errorType=address_error_currency;address_error_chain 的回调信息。
6.2 资金有风险被拦截
商户将收到 biztype=PAY_UNRESOLVED;
且data.errorType=address_risk_address。

关于静态地址的回调信息

1.成功支付入账

将会收到 PAY_SUCCES 的通知,表示支付成功,且到账。

2.异常支付回调

2.1.支付了与订单不一致的币种/网络
商户户将收到 biztype=PAY_UNRESOLVED ;且data.errorType=fix_error_currency;fix_error_chain 的回调信
2.2 风险资金
商户将收到 biztype=PAY_UNRESOLVED;且data.errorType=fix_risk_address 的回调信息。
2.3支付到被删除的静态地址
商户将收到 biztype=PAY_UNRESOLVED;且data.errorType=fix_delete或者fix_partial_delete

3.静态地址风险通知

将会收到 bizType=FIXED_ADDRESS_RISK,bizStatus=RISK_ADDRESS,表示当商户绑定的静态收款地址被识别为风险地址。商户应该立即删除对应的静态地址。倘若用户后续继续往该地址打款,资金不会入账。

免责声明

本文内容仅供参考与学习目的,不构成任何金融、投资、交易或法律建议,也不构成购买或出售任何数字资产的要约或邀请。Gate 对文中信息的准确性、完整性或时效性不作任何明示或暗示的保证。产品功能、界面、规则及费率等信息可能随时更新或调整,请以 Gate 平台的最新公告及实际页面展示为准。

数字资产投资涉及高风险,价格可能出现大幅波动,您可能损失全部投入资金。请在充分了解相关风险的基础上,根据自身财务状况和风险承受能力谨慎决策。如有需要,建议您咨询独立的专业财务或法律顾问。
有关更多风险信息,请参阅 Gate 《风险警示》《用户协议》

立即注册,最高可领 $10,000 迎新奖励
signup-tips