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