新增快手电子凭证后台工具

2026-07-09 18:39:34 +08:00
parent 1bfb32dcd0
commit c61078d3f6
29 changed files with 3034 additions and 474 deletions
@@ -0,0 +1,91 @@
+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"
+}