回调通知

回调通知为您的系统提供实时支付状态更新。本指南解释了如何处理和验证回调请求。

🔄 回调过程

沙盒环境

• 创建沙盒订单
• 点击设置回调模拟成功/失败
• 重要: 支付方式不能为空
• 在您的系统中测试回调处理

生产环境

• 当实际支付发生时自动发送回调
• 无需手动干预
• 实时支付状态更新

仅API订单

回调仅针对通过API创建的订单发送。通过商户平台支付链接创建的订单无法链接到商户系统。

🔐 回调签名验证

签名生成

X-SIGNATURE = SHA256withRSA(smilepayz_private_key, stringToSign)

待签名字符串

stringToSign = tradeNo + "|" + X-TIMESTAMP

验证过程

1. 从回调头部提取X-SIGNATURE和X-TIMESTAMP
2. 使用tradeNo和X-TIMESTAMP构造stringToSign
3. 使用Smilepayz公钥验证签名
4. 如果验证通过，返回SUCCESS字符串

响应

接收回调请求时，只需返回：

SUCCESS

📋 实现步骤

1. 获取平台公钥: 参考集成信息
2. 验证签名: 使用工具文档中的签名验证方法
3. 处理回调: 处理支付状态更新
4. 返回响应: 发送SUCCESS确认

⚠️ 重要说明

• 签名验证: 始终验证回调签名
• 公钥: 使用正确的平台公钥进行验证
• 响应: 仅返回SUCCESS字符串
• 安全: 切勿信任未验证的回调