1. 开发指南
GlobalPay
  • 开发指南
    • 开发前必读
    • 申请API Key 与 API Secret
    • 签名认证
    • 错误码参考
    • 订单状态
    • 常见问题
    • 支付回调通知
  • Api使用指南
    • 查询⽀持的资产
      GET
    • 创建订单
      POST
    • 查询订单
      GET
    • 取消订单
      POST
  1. 开发指南

支付回调通知

订单支付成功后,如果需要回调通知,请向我方提供商户侧回调地址

1 、回调请求格式#

回调 Body 结构(与查询订单响应一致):
{
  "order_hash": "gp_a1b2c3d4e5f6",
  "merchant_order_no": "ORD-20240101-001",
  "pay_address": "TRxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "amount": "100.00",
  "paid_amount": "100.00",
  "currency": "USDT",
  "chain": "TRC20",
  "status": 3,
  "paid_at": 1700000500,
  "tx_hash": "abc123def456..."
}

2、 回调响应要求#

商户服务器需在 5 秒 内返回 HTTP 200 状态码,且响应 Body 包含:
{"code": 0}
若未收到符合要求的响应,系统会按以下策略重试:
重试次数间隔时间
第 1 次立即
第 2 次1 分钟后
第 3 次5 分钟后
第 4 次30 分钟后
第 5 次2 小时后
超过最大重试次数后,回调状态变为已放弃,建议通过查询订单接口主动补单。

3、 回调安全验证#

为防止伪造回调,建议收到通知后主动调用查询订单接口确认订单状态,而不是仅依赖回调数据。
修改于 2026-05-11 06:44:03
上一页
常见问题
下一页
查询⽀持的资产
Built with