设置 Callback Endpoint

本指南介绍如何创建和注册 Callback Endpoint，用于接收和处理来自 Cobo 支付服务的 Callback 消息。

​

创建 Endpoint

选择支持接收和处理 HTTP POST 请求的服务器环境，例如 AWS、Google Cloud 等云服务或自托管服务器。在您的服务器上定义一个 Endpoint URL，Cobo 将向该地址发送 Callback 消息。

​

实现处理逻辑

创建 Endpoint 后，在您的服务器上实现处理 Callback 消息的逻辑。

​

解析 Callback 请求

Cobo 向您注册的 Callback Endpoint 发送 HTTP POST 请求，请求正文即交易对象，包含以下字段：

​

验证签名

为防止未经授权的访问，请通过验证签名来确认每条 Callback 请求的真实性。 验证步骤如下：

1. 获取请求包体的原始数据和时间戳。 从请求 Payload 中提取包体的原始字符串，并从请求头中提取时间戳。
   raw_body = request.body().decode('utf8')
   timestamp = request.headers.get("BIZ_TIMESTAMP")
   
2. 获取签名。 从请求头中获取签名值。
   signature = request.headers.get('BIZ_RESP_SIGNATURE')
   
3. 拼接消息并对其进行哈希处理。
   import hashlib
   
   # Concatenate raw body and timestamp to form the message.
   message = "raw_body|timestamp"
   
   # Compute double SHA-256 hash.
   sha256_hash = hashlib.sha256(hashlib.sha256(message.encode()).digest()).digest()
   
4. 选择 Cobo 的公钥。 根据您使用的环境，选择相应的公钥进行验证：
   • 开发环境：a04ea1d5fa8da71f1dcfccf972b9c4eba0a2d8aba1f6da26f49977b08a0d2718
   • 生产环境：8d4a482641adb2a34b726f05827dba9a9653e5857469b8749052bf4458a86729
5. 使用 Ed25519 算法验证签名。
   import ed25519
   
   # Obtain the verifying key from Cobo's public key.
   vk = ed25519.VerifyingKey(bytes.fromhex(public_key))
   
   # Verify the signature against the computed message hash.
   vk.verify(bytes.fromhex(signature), sha256_hash)
   

​

响应 Callback 请求

您的 Endpoint 必须在 10 秒内响应。返回包含 result 字段的 JSON 正文：

• 批准操作：
  {"result": "ok"}
  
• 拒绝操作：
  {"result": "deny"}
  

如果您的 Endpoint 未能及时响应或返回其他响应，Callback 消息的状态将变为 Failed。

​

注册 Endpoint

回调地址在 Cobo Portal 创建 API 密钥时注册，与 API 密钥绑定。Cobo 会将使用该 API 密钥发起的所有操作的 Callback 消息发送到该地址。

1. 前往 Cobo Portal > 开发者 > API Keys。
2. 点击注册 API Key。
3. 在回调地址部分，点击添加回调地址。
4. 输入您的 Endpoint URL 和可选的描述信息。
5. 点击注册保存回调地址。
6. 点击注册密钥完成 API 密钥注册。

​

注意事项