open.seller.order.refund.approve
需商家授权
POST
商家同意退款
更新时间: 2023-11-01 14:45:53
1.售后单类型为仅退款时,调用该API完成退款操作
2.售后单类型为退货退款时,使用open.seller.order.refund.returngoods.approve(商家同意退货API)完成同意退货操作
系统环境
环境	域名
线上环境（推荐）	https://openapi.kwaixiaodian.com
线上环境（备用）	https://open.kwaixiaodian.com
系统参数
参数名	类型	必须	详情描述
appkey	String	是	平台分配的appId
timestamp	Number	是	发起请求的Unix时间戳，单位为毫秒
access_token	String	是	访问token，所有需用户授权API使用code模式获取，不需要用户授权API使用client_credentials获取，详情参考《授权说明》文档
version	Number	是	请求的API版本号，目前版本为1
param	JSON	是	业务参数，详见下方的请求入参
method	String	是	请求的API英文名，详见各API定义
sign	String	是	API入参的签名结果参数
signMethod	String	是	签名算法，支持HMAC_SHA256和MD5，推荐使用HMAC_SHA256
请求参数
参数名	类型	必须	示例值	详情描述
refundId	Long	是	129230087	退款单编号
desc	String	否	说明	退款说明（预计4月中旬下线）
refundAmount	Long	是	1000	退款金额 单位：分
status	Integer	否	1	退款单当前状态
negotiateStatus	Integer	否	1	协商状态，枚举： [1, "待商家处理"] [2, "商家同意"] [3, "商家驳回，等待买家修改"]
refundHandingWay	Integer	否	1	退款方式，枚举：[0, "未知"] [1, "退货退款"] [10,"仅退款"]
返回参数
参数名	类型	示例值	详情描述
code	String	1	主返回码
msg	String	success	主返回信息
sub_code	String	1	子返回码
sub_msg	String	SUCCESS	子返回信息
result	Integer	1	返回码，1正确，其他返回码表示接口未执行成功
error_msg	String	SUCCESS	返回码描述
错误码
错误码	错误类型	错误描述	解决方法
16	系统错误	请求过于频繁	请求过于频繁，请稍后重试
21	业务错误	当前退款单状态已更新	当前退款单状态已更新，请刷新后重试
1004	系统错误	服务繁忙	服务繁忙，请稍后重试
3616	业务错误	当前退款单状态已更新	当前退款单状态已更新，请刷新后重试
6002	业务错误	保证金余额不足	保证金余额不足，请检查
300009	业务错误	退款金额为0	退款金额为0，请检查
300011	业务错误	退款单不存在	退款单不存在，请检查
300013	业务错误	买家取消退款	买家取消退款
300014	业务错误	退款单状态已更新	退款单状态已更新，请刷新重试
300108	业务错误	输入的退款金额与退款单实际金额不匹配	输入的退款金额与退款单实际金额不匹配，请检查
请求示例
JAVA
CURL
package com.kuaishou.merchant.open.api.sdk.demo;
import com.kuaishou.merchant.open.api.common.utils.GsonUtils;
import com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundApproveRequest;
import com.kuaishou.merchant.open.api.response.refund.OpenSellerOrderRefundApproveResponse;
import com.kuaishou.merchant.open.api.client.AccessTokenKsMerchantClient;

public class AccessTokenKsMerchantClientDemo {

    public static void main(String[] args) {
        String url = "https://openapi.kwaixiaodian.com";
        String appKey = "your appKey";
        String signSecret = "your app signSecret";
        String accessToken = "your accessToken";

        AccessTokenKsMerchantClient client = new AccessTokenKsMerchantClient(url,appKey,signSecret);

        OpenSellerOrderRefundApproveRequest request = new OpenSellerOrderRefundApproveRequest();
        request.setAccessToken(accessToken);
        request.setApiMethodVersion(1L);

        request.setRefundId(129230087);
        request.setDesc("说明");
        request.setRefundAmount(1000);
        request.setStatus(1);
        request.setNegotiateStatus(1);
        request.setRefundHandingWay(1);

        OpenSellerOrderRefundApproveResponse response = client.execute(request);

        System.out.println(GsonUtils.toJSON(response));
    }
}

响应示例
JSON
{
  "result": 1,
  "error_msg": "SUCCESS"
}