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

  1. 支付金额说明

在接收到支付成功的回调后,请以回调参数中的 orderActualAmount 字段作为实际到账金额的准确信息进行处理,避免由于支付金额不一致造成商户资金损失。

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

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

  1. 关于重复回调

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

json

{ ``  "code": 200, ``  "success": true ``}
  1. IP 白名单设置(客户端回调服务需加白)

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

  1. 回调失败常见问题:IP 受限

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

  • 所有服务端(下单/回调)所在的公网 IP
  • 商户回调地址所绑定服务器的公网 IP
  • 可用出口 IP(若使用云厂商负载均衡等)
  1. AccessKey 生效时间说明

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