申请退款

# 特别说明

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

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

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

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


# 申请退款接口

nuomi.cashier.applyorderrefund

# 请求地址

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

TIPS:申请退款API逐步升级。新开发者建议接入新正式环境;历史环境不影响正常使用,已接入开发者建议尽快切到新正式环境中。

# 请求参数说明

名称 类型 是否必须 示例值 描述
method String nuomi.cashier.applyorderrefund API 接口名称,使用历史环境该字段为必填,新正式环境无需传该字段
orderId Long 800200451 百度平台订单 ID
userId Long 2250333905 百度用户 ID
refundType Integer 1 退款类型:1:用户发起退款;2:业务方客服退款;3:业务方服务异常退款
refundReason String “充值未到账” 业务方发起退款的原因
tpOrderId String 10000234 业务方唯一订单号
appKey String MMM4hG appKey
rsaSign String rsa 签名,所有参数参与签名,详见签名与验签
applyRefundMoney Integer 100 退款金额,单位:分,发起部分退款时必传
bizRefundBatchId String 12132434546634535 业务方退款批次 id,退款业务流水唯一编号,发起部分退款时必传

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

# 返回说明

名称 类型 是否必须 示例值 描述
errno Integer 0 返回码
msg String success 返回信息
data Object [] 返回数据

# 返回示例

{
    "errno": 0,
    "msg": "success",
    "data": {
        "refundBatchId": "152713835",//平台退款批次号
        "refundPayMoney": "9800" //平台可退退款金额【分为单位】
    }
}