代理商接口列表 (部分退款)

需要授权

当交易发生之后一段时间内,由于商户的原因需要部分退款时,商户可通过该退款接口将需退款金额退还给交易者,哆啦宝将在收到退款请求并且验证成功之后,按照部分退款规则将需退款金额按原路退至交易者。交易时间不在系统退款周期内的订单将无法提交退款。部分退款支持单笔交易分多次退款(最多两次),累计退款金额不能超过用户实际支付金额。

请求参数:

POST请求地址:

环境 http请求地址
正式环境 https://openapi.duolabao.cn/v1/agent/order/refund/part

公共请求参数:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
agentNum String 32 代理商编号 10001114495558121971726
customerNum String 32 商户号 10001114596730086163709
shopNum String 32 店铺编号 10001214641783052104486
requestNum String 32 流水号(用户系统内唯一) 2014072300007148
refundPartAmount String 32 退款金额 0.01

请求示例:

  • 示例
  • 1 {
    2 "agentNum": "10001114495558121971726",
    3 "customerNum": "10001114596730086163709",
    4 "shopNum": "10001214513673242442196",
    5 "requestNum": "315080832507485",
    6 "refundPartAmount": "0.01"
    7 }

返回参数JSON格式:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
result String 32 success表示成功,fail表示失败,error表示异常 success
orderNum String 32 订单编号 10021014497548368512422
refundAmount String 15,2 退款金额 10.05
errorCode String 32 错误码 shopNumNotExist
errorMsg String 32 错误信息 shopNum not exist

响应示例:

  • JSON示例
  • 1 {
    2 "data": {
    3 "orderNum": "10021014497548368512422",
    4 "refundAmount": "10.05"
    5 },
    6 "result": "success"
    7 }

错误响应示例:

  • 错误响应示例
  • 1 {
    2 "error": {
    3 "errorCode": "shopNumNotExist",
    4 "errorMsg":"shopNum not exist"
    5 },
    6 "result": "fail"
    7 }

异常示例:

  • 异常示例
  • 1 {
    2 "error": {
    3 "errorCode": "systemError",
    4 "errorMsg":"错误描述"
    5 },
    6 "result": "error"
    7 }

错误码解释:

错误码 错误描述 解决方案
paramsError requestNum must be specified 参数不正确
customerNotExist customer not exist 商户不存在
shopNotExist requestNum invalid 流水号无效,请确认流水号
orderNotExist order not exist 订单不存在
orderHasNotPayRecord order has not pay record 订单无支付记录
accountStatusError account status error 账户状态错误
settleProcess settle process 结算处理中
notEnoughBlance not enough blance 账户余额不足
accountOutRepeat account out repeat 重复出账
orderIsRefund order is refund 订单已退款
orderNotRefunding order not refunding 订单不是退款中状态
refundAmountOut refund amount out 金额超过可退金额
refundCountOut refund count out 超过退款次数
refundTimeOut refund time out 退款日期已过
refundAmountError refund amount error 退款金额有误
orderNotComplete order not complete 订单未完成