代理商接口列表 (退款)

需要授权

当交易发生之后一段时间内,由于代理商的原因需要退款时,代理商可以通过退款接口将交易款退还给交易者,哆啦宝将在收到退款请求并且验证成功之后,按照退款规则将交易款按原路退至交易者帐号上。总退款金额不能超过用户实际交易金额。

请求参数:

POST请求地址:

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

公共请求参数:

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

请求示例:

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

返回参数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 订单不是退款中状态