Skip to content

订单回调通知

IMPORTANT

如果您确认处理了订单回调并希望我方服务不再重复通知,您可以使用 HTTP 状态码 200 响应固定字符串 "success"(不包含引号)。

请您自行确认正常处理订单回调的幂等逻辑,避免因被重复回调导致您系统数据错误。我们可能会对您进行多次的通知,如您没有正确回复处理结果,我方系统将不定时发送多次尝试。

[!TIPS] 沙箱在您正常提交之后,会自动回调到应用配置的地址上,请求方法为 POST,请求数据类型为 application/json

我们将进行多次重试,请确保自行处理幂等逻辑,避免订单被重复操作。

请求参数

json
{
  "appKey": "NO9pn4tMn3aIvwX95CyxFlFzexXmzOFp",
  "version": 10000,
  "timestamp": 1758634162422,
  "content": "zzMvuQIn8wD5wV68jRvJEimnoLrCMumVIUDcRukB2bAc8rAGIQSv1WzT8tJ7JrYVeSHH9v0FczOCcw8ya2Vh1Puf6z1/rYizMsMlZ0Mxe85a2KnJHPCWQOSpRIwfLgdmimsl/Wy6C56vnWN4GQ5q9gYwgfmScEzwhUDQSb6Gg+cPio8s2YQVWClbB6P1qY+KxzjgEJWszhkWcViNncmZpzxoPe0HHW5Kj6hUfTbPFYvxW+opZ0hk1I0+Iv4Gokusd6vBkr8k7UCZ45a83GEL5g==",
  "nonce": "9vTpJuqg1Y601qbJ6FL9aZKEI7hURWBh",
  "signature": "86c83642c2413fdb0d14ece56f7cee4ede78b0a8"
}

您可以参考签名部分,使用同样的方式对上面的数据进行签名,并验证签名是否和传入的 signature 一致,如果一致,则说明签名成功,可以进行解密,并解析参数。

解析订单参数

返回订单模型,详情请查看 订单模型

响应成功状态

IMPORTANT

明确订单状态为 SUCCESS 时,明确表示支付成功。其他任何情况均不代表支付成功。

响应失败状态

IMPORTANT

明确订单状态为 FAIL 时,明确表示支付失败。

已明确订单支付失败 ,此时请自行处理退款流程,并尝试使用新的外部订单号重新发起新的支付。

其他状态

IMPORTANT

您可能会收到除了 SUCCESS FAIL 之外的其他诸如 PAYING 等状态的回调

除了 SUCCESS FAIL 之外,其他状态的回调均只作为订单状态变更和心跳通知,该类通知为不定期发送,不作为订单终态变更的依据。

如果您不关心订单处理的中间过程,请直接忽略此类通知