通知退款状态

使用场景

百度收银台调用业务方的退款审核接口成功，且业务方返回允许退款后，平台会去做退款操作，当订单退款成功后，百度收银台会主动调用业务方的退款回调地址（开发者平台注册的退款回调地址）通知业务方该订单退款成功。

接口注意事项

  1. 幂等性：业务方接口需要具备幂等性平台技术术语—-幂等性；

  2. 超时时间：业务方接口的耗时要求小于 2s（超过 2s 会触发平台的超时重试，重试间隔：2min/4min/10min/30min/1h…）；

  3. 返回值判断：errno 为 0 表示商户已经成功收到退款成功信息，并妥善处理。errno 不为 0 将认为是同步退款结果信息失败，会发起重试（不限次数，重试间隔：2min/4min/10min/30min/1h…）；

  4. 订单状态同步：商家收到通知退款状态回调切严格按照文档提示返回参数，后台订单状态才会同步且显示“已退款”；

如未收到回调请求，请检查服务器网关是否有准入限制，如有限制参照阿里云安全组设置中的 IP 地址设置白名单。

通知参数说明

参数参数名称类型（长度范围）参数说明是否可空样例
userId用户 IDLong百度用户 ID是149235070
orderId订单 IDLong百度平台订单 ID否1068881223
tpOrderId业务方订单 IDString业务方订单 ID是11119800
refundBatchId退款批次号String平台退款批次号【幂等性标识参数】(用于重入判断)否149235070
refundStatus退款状态Int1：退款成功，2：退款失败否1
rsaSign参数签名String平台生成的 sign是全部参数参与签名，详见签名与验签

备注：这里对全部参数签名是对平台的所有 POST 参数进行签名，如果商户 URL 里包含 GET 类型参数，不会参与签名。验签需要使用正确格式的平台公钥，可以在服务详情中查询，详见签名与验签第 8 项内容。

返回参数说明

名称类型是否必须示例值描述
errnoInt是0返回码
msgString是success返回信息
dataObject是{“auditStatus”:1,”calculateRes”:{“refundPayMoney”:100}}返回数据

通知触发条件

退款成功后，平台会调用该接口，将退款成功消息通知到业务方。

业务方服务器通知参数获取

  1. 百度收银台是用 POST 方式发送通知信息，参数以 URL param 的方式返回。

    PHP 服务推荐参数获取方式：$_POST[‘xxx’]。

    Java 服务推荐参数获取方式：@RequestParam(value=”xxx”)。

  2. 百度收银台主动发起通知，该方式才会被启用。

  3. 程序执行完后须同步返回符合要求的 JSON 字符串。如果商户返回给百度收银台的字符不是合法 JSON 或者解析出来的 errno 不为 0，会再次重发。

业务方通知参数合法性验证

当百度收银台通过调用接口同步退款信息给给业务方时，业务方获得这些数据后，必须进行如下处理:

  1. 验证签名

    首先必需验证签名，然后验证是否是百度收银台发来的通知，请参见签名与验签。

  2. 业务数据处理注意事项

    业务方需要验证该通知数据中的 orderId 是否为业务方系统中记录的百度订单号，若未发现该订单，则表明本次通知是异常通知，务必忽略。在上述验证通过后业务方请处理退款成功消息，将处理结果返回。如果商户未正确处理业务通知，存在潜在的风险，业务方自行承担因此而产生的所有损失。

DEMO

  • 入参(REQUEST) DEMO：
  1. https:://xxx.tpbusiness.xxx/notifyRefundRes?orderId=800020199&refundBatchId=100058888&refundStatus=1&rsaSign=Gzu1RT2toJSDthcLPG1ZWROI3jzvxFtO7yCPUqMT3L7cmnARncm5IIIQ6x+7S/02zWxr5FC9945WFSurO9kepVbU7YS6Lh9SEVQhvTO0YKG7TlLFTpH3Ik7JeHQalAKXYe/jNREDpHmTF9Jrq/wABeZGYXJn1M75A37h9zUt+kw=
  • 返回(RESPONSE) DEMO:
  1. {
  2.     "errno": 0,
  3.     "msg": "success",
  4.     "data": {}
  5. }