跳转到内容

订单回调

代收订单回调

当用户支付成功后,系统将通过订单中的回调 URL 通知商户(请注意回调可重复发送,如果您的系统中订单本身已处理,请忽略些回调请求)。

  • 调用方法: POST JSON
  • 请求参数:
参数名类型说明
idstring平台唯一订单 ID
mch_idnumber商户 ID
trans_idstring商户订单 ID
channelstring通道
order_amountnumber订单金额
payed_amountnubmer用户实付金额,当此金额与 order_amount 不一致时请不要上分
created_atstring订单创建时间
payed_atstring订单支付时间(仅在订单成功时才有)
statusnumber订单状态,60 为成功,20 为正在处理中,其他均为失败
signstring参数签名。参见签名算法

回调注意事项:

  • 回调成功,请返回字符串 success
  • 超时与重试。当前系统回调超时时间为 10 秒,请在此时间段内返回。若首次回调失败,系统将每隔 30 秒再次回调,连续五次失败调用之后,将不会再尝试自动回调
  • 请注意 payed_amount 字段,此为用户实际支付的金额。此金额不一定会与下单金额一致(如用户修改支付金额),请在收到回调的时候,一定要判断是否与下单金额一致,再决定是否要上分

代付订单回调

代付成功后,系统将通过订单中的回调 URL 通知商户(请注意回调可重复发送,如果您的系统中订单本身已处理,请忽略些回调请求)。

  • 调用方法: POST JSON
  • 请求参数:
参数名类型说明
idstring平台唯一订单 ID
mch_idnumber商户 ID
trans_idstring商户订单 ID
order_amountnumber订单金额
created_atstring订单创建时间
canceled_atstring订单取消时间(仅在订单取消后才有)
payed_atstring订单支付时间(仅在订单成功时才有)
statusnumber订单状态,60 为成功,20 为正在处理中,其他均为失败
signstring参数签名。参见签名算法

回调注意事项:

  • 回调成功,请返回字符串 success
  • 超时与重试。当前系统回调超时时间为 10 秒,请在此时间段内返回。若首次回调失败,系统将每隔 30 秒再次回调,连续五次失败调用之后,将不会再尝试自动回调

Released under the MIT License.