Appearance
订单回调通知
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 之外,其他状态的回调均只作为订单状态变更和心跳通知,该类通知为不定期发送,不作为订单终态变更的依据。
如果您不关心订单处理的中间过程,请直接忽略此类通知。
