4.1 KiB
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" }