# ⚠️回调说明 · 接入前必读!
- 支付金额说明
在接收到支付成功的回调后,请以回调参数中的 orderActualAmount
字段作为实际到账金额的准确信息进行处理,避免由于支付金额不一致造成商户资金损失。
- 回调/查询接口,字段需要做空判断
可能在不同的业务或者不同的状态中,订单的某些字段会返回空值。比如在等待支付时,这时候查询订单,支付订单时间为空。商户在接入时,对所有字段需要做空判断,以免查询/回调报错。
- 关于重复回调
系统会在一定条件下重试回调,请开发者务必确认回调响应是否正确返回以下内容,确保系统识别响应成功并停止重试:
json
{ `` "code": 200, `` "success": true ``}
- IP 白名单设置(客户端回调服务需加白)
请在【开发者中心 → API KEY】中,将回调服务的 公网 IP 添加到 白名单输入框中,确保回调请求可正常访问。
- 回调失败常见问题:IP 受限
请确认以下 IP 已全部加入白名单:
- 所有服务端(下单/回调)所在的公网 IP
- 商户回调地址所绑定服务器的公网 IP
- 可用出口 IP(若使用云厂商负载均衡等)
- AccessKey 生效时间说明
AccessKey 创建后约需 2 分钟生效,请确保使用时已完成初始化同步。若报 ACCESS_KEY_INVALID
,请稍后重试。