⚠️ 回调说明 · 接入前必读！

1.回调/查询接口，字段需要做空判断

可能在不同的业务或者不同的状态中，订单的某些字段会返回空值。比如在等待支付时，这时候查询订单，支付订单时间为空。商户在接入时，对所有字段需要做空判断，以免查询/回调报错。

2.关于重复回调

系统会在一定条件下重试回调，请开发者务必确认回调响应是否正确返回以下内容，确保系统识别响应成功并停止重试：

{ "code": 200,  "success": true}

3.IP 白名单设置（客户端回调服务需加白）

请在【开发者中心 → API KEY】中，将回调服务的 公网 IP 添加到 白名单输入框中，确保回调请求可正常访问。

4.回调失败常见问题：IP 受限

请确认以下 IP 已全部加入白名单：

• 所有服务端（下单/回调）所在的公网 IP
• 商户回调地址所绑定服务器的公网 IP
• 可用出口 IP（若使用云厂商负载均衡等）

5.AccessKey 生效时间说明

AccessKey 创建后约需 2 分钟生效，请确保使用时已完成初始化同步。若报 ACCESS_KEY_INVALID，请稍后重试。