支付回调通知

回调通知是 Spell 与您的应用程序进行通信的重要机制，它允许 Spell 在特定事件发生时，主动向您配置的服务器地址发送事件通知。

什么是回调通知？

回调通知（Callback Notification）是一种服务器之间（Server-to-Server）的通信方式。当 Spell 系统中发生符合回调配置的重要事件时（如支付成功、订单状态变更等），我们会通过 POST 请求将这些事件信息实时推送到您预先设定的接收地址（Callback URL）。

为什么需要回调通知？

• 实时性：无需主动轮询API接口查询订单的状态变化，Spell 会在事件发生的第一时间通知您的系统。
• 可靠性：通过数字签名机制确保通知的真实性和完整性，防止数据被篡改或伪造。
• 自动化：使您的系统能够自动响应各种业务事件（如确认订单创建成功、发送卡密信息），实现完整的自动化业务流程。

核心概念

一个账户可以配置多个回调事件，回调系统只有在注册后才能正常运行。回调配置包含以下核心概念：

• 回调事件：触发通知的具体操作或状态变更，如订单已支付、订单已逾期。
• 回调地址：您提供的用于接收通知的服务器端点地址。
• 签名验证：使用特定算法对通知内容进行签名，确保通知来源的可信度和数据的完整性。

工作原理

1. 事件发生：Spell 系统中发生需要通知您的事件
2. 构造通知：Spell 组织通知数据并生成数字签名
3. 发送请求：向您的回调地址发送 POST 请求（包含签名头）
4. 验证处理：您的服务器验证签名并处理业务逻辑
5. 确认接收：返回成功响应避免重复通知

常见使用场景

• 支付结果通知：实时接收支付成功、失败或退款等状态更新
• 订单状态同步：获取订单生命周期中的各种状态变更
• 用户行为跟踪：监控用户相关的特定操作和事件
• 系统事件告警：接收系统级别的告警和通知信息

继续阅读

• 注册回调配置
• 接收回调通知