GCash 商户回调怎么做?支付通知、验签与对账闭环(2026)

2026-09-24 20:00:00

GCash 商户回调是通道把支付结果异步推给商户服务器的必经环节——做扎实业务能闭环,做得糙就漏单、重复发货。回调侧四道关卡:签名验证、幂等处理、失败重试、对账兜底,一道都不能省。

一、GCash 回调是什么、什么时候触发

回调(Notify / Webhook)是支付通道在交易状态变化时,主动向商户预留的回调地址推送 HTTP 请求。触发场景包括支付成功、支付失败、退款完成、订单超时关闭等。发起支付时的同步返回只是「请求已受理」的信号,真正的账务动作要以异步回调结果为准,这是四方网关与电子钱包对接的通用协议。

二、四道关卡怎么设计

签名验证:每条回调都带签名字段(常见 HMAC-SHA256 或 RSA),用商户密钥或通道公钥重算,不匹配直接丢弃并落日志。
幂等处理:以订单号 + 通道流水号做联合主键,重复回调直接返回 SUCCESS,不再进业务逻辑。
失败重试:通道方按退避策略持续重推,商户端要区分「暂时失败(返回失败让它重推)」和「永久失败(先入库存证再回 SUCCESS)」。
对账兜底:回调可能因网络抖动、超时、代码 bug 丢失,必须配合日终或日内批量对账拉单补回。

三、上线前 checklist

回调地址走 HTTPS,IP 白名单或域名固定,防止被伪造。
接收后先落日志表(raw body + header + 时间戳),再走验签。
验签通过后,以订单号查本地状态——已终态直接 SUCCESS,进行中才推进后续。
业务处理与状态更新放在同一事务里,避免半成功。
返回通道约定的成功标识,失败订单进重试队列并加入日终对账兜底。

四、通过 SMARTPAY 快速接入(推荐路径)

SMARTPAY 作为四方支付网关,把通道层复杂的签名协议、重试策略、对账文件解析统一封装。商户只需对接一次网关侧回调协议,即可覆盖 GCash、Maya、QRPH 等多通道,不用为每个通道重写解析与验签。技术细节参考 GCash 收款 API 对接教程,商户号申请路径见 GCash 商户号怎么办。

SMARTPAY 是持 BSP OPS/EMI 牌照的独立支付网关,提供 GCash / QRPH / Maya 等通道对接服务,非 GCash 官方。

五、常见问题

没收到回调怎么办?

先看通道后台的推送日志,确认通道方有没有发出、返回的 HTTP 状态码是什么。常见坑是接收方地址被 CDN 或防火墙拦截、或者没返回正确的成功标识。找不到就走主动查单接口,或等对账文件回补。

回调收到两次会重复发货吗?

只要幂等做到位不会。以订单号做数据库唯一索引,第二次落库直接抛主键冲突,再走「已处理」分支返回 SUCCESS。不能用「内存去重」,服务重启就失效。

只靠回调够吗,还需要对账吗?

必须对账。回调是「尽力送达」不是「必达」,丢单是低概率但迟早会遇到的事件。日终对账拉通道流水与本地订单表两侧比对,是财务合规与防止漏账的最后一道防线。

六、快速开通

想快速接入合规支付通道,联系 SMARTPAY:📩 [email protected] | Telegram @LouisSMARTPAY