Files
order_site/docs/行业电子凭证/解决方案/相关文档/2.2.商家不同意退款接口.md
T

83 lines
3.8 KiB
Markdown

open.seller.order.refund.disagree.refund
需商家授权
POST
商家不同意退款
更新时间: 2021-12-21 11:35:17
商家不同意退款
系统环境
环境 域名
线上环境(推荐) 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 退款单id
sellerDisagreeReason Integer 是 1 商家拒绝原因,枚举:[1 商品退回后才能退款] [2 家已签收] [3 买家未举证/举证无效] [4 已发货,请买家承担运费] [5 已履行约定"] [100 其他]
sellerDisagreeDesc String 是 不同意 商家拒绝原因说明
sellerDisagreeImages List<String> 否 [] 拒绝图片,最多6张
status Integer 是 10 退款单当前状态,枚举:[10, "买家仅退款申请"] [11, "买家退货退款申请"] [20, "平台介入-买家仅退款申请"] [21, "平台介入-买家退货退款申请"] [22, "平台介入-已确认退货退款"] [30, "商品回寄信息待买家更新"] [40, "商品回寄信息待卖家确认"] [50, "退款执行中"] [60, "退款成功"] [70, "退款失败"]
negotiateStatus Integer 是 1 协商状态(以退款单信息里返回值为入参),枚举:[1,"待商家处理"] [3, "商家驳回,等待买家修改"]
返回参数
参数名 类型 示例值 详情描述
code String 1 主返回码
msg String success 主返回信息
sub_code String 1 子返回码
sub_msg String SUCCESS 子返回信息
result Integer 1 返回码,1正确,其他返回码表示接口未执行成功
error_msg String SUCCESS 返回码描述
错误码
错误码 错误类型 错误描述 解决方法
暂无数据
请求示例
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.OpenSellerOrderRefundDisagreeRefundRequest;
import com.kuaishou.merchant.open.api.response.refund.OpenSellerOrderRefundDisagreeRefundResponse;
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);
OpenSellerOrderRefundDisagreeRefundRequest request = new OpenSellerOrderRefundDisagreeRefundRequest();
request.setAccessToken(accessToken);
request.setApiMethodVersion(1L);
request.setRefundId(129230087);
request.setSellerDisagreeReason(1);
request.setSellerDisagreeDesc("不同意");
List<String> list1 = new ArrayList<>();
list1.add("");
request.setSellerDisagreeImages(list1);
request.setStatus(10);
request.setNegotiateStatus(1);
OpenSellerOrderRefundDisagreeRefundResponse response = client.execute(request);
System.out.println(GsonUtils.toJSON(response));
}
}
响应示例
JSON
{
"result": 1,
"error_msg": "SUCCESS"
}