申请退款

特别说明

防止资金池金额小于退款金额时退款失败的情况,建议根据业务退款情况,在“管理中心——支付服务设置——我的服务——服务——财务设置”设置“每日退款上限(元)”和“打款预留(元)”。

  • 每日退款上限(元) :设置每日退款上限。当日退款达到设置金额时,当日新发起的退款都会失败。

  • 打款预留(元):结款日资金池预留的不打款的金额,保证资金池有金额退款。

发起部分退款时,订单必须是核销状态。

申请退款接口

  1. nuomi.cashier.applyorderrefund

请求地址

环境HTTPS 请求地址
新正式环境https://etrade-api.baidu.com/cashier/applyOrderRefund
历史环境https://nop.nuomi.com/nop/server/rest (即将废弃,请尽快切到上面新正式环境中)

TIPS:

  1. 请求方式:支持 POST/GET 表单提交。
  2. 申请退款 API 逐步升级。新开发者建议接入新正式环境;历史环境不影响正常使用,已接入开发者建议尽快切到新正式环境中。

请求参数说明

名称类型是否必须示例值描述
methodStringnuomi.cashier.applyorderrefundAPI 接口名称,使用历史环境该字段为必填,新正式环境无需传该字段
orderIdLong800200451百度平台订单 ID
userIdLong2250333905百度用户 ID
refundTypeInt1退款类型:1:用户发起退款;2:业务方客服退款;3:业务方服务异常退款
refundReasonString“充值未到账”业务方发起退款的原因
tpOrderIdString10000234业务方唯一订单号
appKeyStringMMM4hGappKey
rsaSignStringrsa 签名,所有参数参与签名,详见签名与验签
applyRefundMoneyInt100退款金额(单位:分),发起部分退款时必传
bizRefundBatchIdString12132434546634535业务方退款批次 id,退款业务流水唯一编号,发起部分退款时必传

发送请求时需要对可能包含中文及特殊字符的字段进行 UrlEncode 操作,对于除中文及特殊字符的参数不需要进行 UrlEncode。

返回说明

名称类型是否必须示例值描述
errnoInt0返回码
msgStringsuccess返回信息
dataObject[]返回数据

返回示例

  1. {
  2. "errno": 0,
  3. "msg": "success",
  4. "data": {
  5. // 平台退款批次号
  6. "refundBatchId": "152713835",
  7. // 平台可退退款金额【分为单位】
  8. "refundPayMoney": "9800"
  9. }
  10. }