售后服务
快手小店售后服务API，提供完整的退款退货处理功能。支持退款申请、退货处理、售后订单查询、争议处理等核心业务场景，帮助商家高效处理售后相关事务。
异步售后服务
kwaixiaodian.client.services.refund.AsyncRefundService(client: AsyncBaseClient)
异步售后服务
提供退款退货、协商处理、售后状态查询等功能。
说明
- OpenAPI 对齐策略：以 src/kwaixiaodian/models/refund.py 中请求模型的
api_method 与 http_method 为准，并与 Java 参考实现严格映射。
- Java 参考路径示例：java_sdk_reference/decompiled_source/com/kuaishou/...。
- 异常：所有方法在底层请求失败或返回错误码时会抛出 KwaixiaodianAPIError。
初始化售后服务
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
client
|
AsyncBaseClient
|
基础客户端实例 |
必需 |
方法：
| 名称 | 描述 |
|---|---|
list |
获取卖家退款单分页列表（游标分页） |
get |
获取卖家退款详情 |
reject |
拒绝退款 |
direct_refund |
直接退款 |
list_refund_comments |
获取退款评论列表 |
list_refund_basic_comments |
获取退款基本评论列表 |
get_reject_reason |
获取拒绝原因 |
add_evidence |
添加退款证据 |
confirm_and_send |
确认并发送退货 |
submit_return_info |
提交退货信息 |
list_seller_refunds |
获取卖家订单退款分页列表 |
get_seller_refund_detail |
获取卖家订单退款详情 |
apply_entry |
卖家退款申请入口 |
post_apply_entry |
卖家退款售后申诉入口 |
disagree_refund |
卖家不同意退款 |
get_evidence_history |
退款证据历史 |
get_fee_detail |
退款费用明细 |
get_history |
退款历史 |
approve_seller_refund |
卖家订单退款审批 |
approve_return_goods |
卖家订单退货审批 |
confirm_receipt |
卖家订单退款确认收货 |
Functions
list(access_token: str, begin_time: int, end_time: int, refund_status: Optional[RefundStatus] = None, refund_type: Optional[int] = None, page_size: int = 20, pcursor: Optional[str] = None, uid: Optional[int] = None) -> SellerOrderRefundPcursorListResponse
async
获取卖家退款单分页列表（游标分页）
OpenAPI: open.seller.order.refund.pcursor.list (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundPcursorListRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundPcursorListRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
begin_time
|
int
|
开始时间戳（毫秒） |
必需 |
end_time
|
int
|
结束时间戳（毫秒） |
必需 |
refund_status
|
Optional[RefundStatus]
|
退款单状态过滤 |
None
|
refund_type
|
Optional[int]
|
退款类型：1-仅退款，2-退货退款 |
None
|
page_size
|
int
|
页面大小 |
20
|
pcursor
|
Optional[str]
|
游标，用于增量翻页 |
None
|
uid
|
Optional[int]
|
用户ID（可选，作为最后一个可选参数） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundPcursorListResponse |
SellerOrderRefundPcursorListResponse
|
卖家退款单分页列表结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回非 0 错误码或解析失败时抛出。 |
get(access_token: str, refund_id: int, uid: Optional[int] = None) -> SellerOrderRefundDetailResponse
async
获取卖家退款详情
OpenAPI: open.seller.order.refund.detail (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundDetailRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundDetailRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundDetailResponse |
SellerOrderRefundDetailResponse
|
卖家退款详情 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
reject(access_token: str, refund_id: int, reason_code: Optional[int] = None, reject_desc: Optional[str] = None, reject_images: Optional[List[str]] = None, refund_version: Optional[int] = None, edit_handling_way: Optional[int] = None, edit_return_address_id: Optional[int] = None, uid: Optional[int] = None) -> RefundRejectResponse
async
拒绝退款
OpenAPI: open.refund.reject (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundRejectRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundRejectRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
reason_code
|
Optional[int]
|
拒绝原因编码 |
None
|
reject_desc
|
Optional[str]
|
拒绝说明 |
None
|
reject_images
|
Optional[List[str]]
|
拒绝凭证图片URL列表 |
None
|
refund_version
|
Optional[int]
|
退款版本号 |
None
|
edit_handling_way
|
Optional[int]
|
处理方式（平台定义） |
None
|
edit_return_address_id
|
Optional[int]
|
退货地址ID |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundRejectResponse |
RefundRejectResponse
|
拒绝退款结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
direct_refund(access_token: str, refund_id: int, refund_version: int, uid: Optional[int] = None) -> RefundDirectResponse
async
直接退款
OpenAPI: open.refund.direct.refund (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundDirectRefundRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundDirectRefundRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
refund_version
|
int
|
退款版本号 |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundDirectResponse |
RefundDirectResponse
|
直接退款结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
list_refund_comments(access_token: str, refund_id: int, uid: Optional[int] = None) -> RefundCommentListResponse
async
获取退款评论列表
OpenAPI: open.refund.comment.list (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundCommentListRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundCommentListRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundCommentListResponse |
RefundCommentListResponse
|
退款评论列表 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
list_refund_basic_comments(access_token: str, refund_id: int, uid: Optional[int] = None) -> RefundCommentBasicListResponse
async
获取退款基本评论列表
OpenAPI: open.refund.comment.basic.list (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundCommentBasicListRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundCommentBasicListRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundCommentBasicListResponse |
RefundCommentBasicListResponse
|
退款基本评论列表 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
get_reject_reason(access_token: str, refund_id: int, uid: Optional[int] = None) -> RefundRejectReasonResponse
async
获取拒绝原因
OpenAPI: open.refund.reject.reason (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundRejectReasonRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundRejectReasonRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundRejectReasonResponse |
RefundRejectReasonResponse
|
拒绝原因详情 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
add_evidence(access_token: str, refund_id: int, image_data: List[str], content: str, uid: Optional[int] = None) -> RefundEvidenceAddResponse
async
添加退款证据
OpenAPI: open.refund.evidence.add (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundEvidenceAddRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundEvidenceAddRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
image_data
|
List[str]
|
证据图片数据列表（Base64 或平台要求的格式） |
必需 |
content
|
str
|
证据描述内容 |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundEvidenceAddResponse |
RefundEvidenceAddResponse
|
添加证据的处理结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
confirm_and_send(access_token: str, refund_id: int, express_no: str, express_code: int, uid: Optional[int] = None) -> RefundConfirmAndSendResponse
async
确认并发送退货
OpenAPI: open.refund.confirm.and.send (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundConfirmAndSendRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundConfirmAndSendRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
express_no
|
str
|
快递单号 |
必需 |
express_code
|
int
|
快递公司代码 |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundConfirmAndSendResponse |
RefundConfirmAndSendResponse
|
确认并发送退货的结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
submit_return_info(access_token: str, refund_id: int, express_no: str, express_code: int, uid: Optional[int] = None) -> RefundSubmitReturnInfoResponse
async
提交退货信息
OpenAPI: open.refund.submit.returnInfo (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundSubmitReturninfoRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundSubmitReturninfoRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
express_no
|
str
|
快递单号 |
必需 |
express_code
|
int
|
快递公司代码 |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundSubmitReturnInfoResponse |
RefundSubmitReturnInfoResponse
|
提交退货信息的结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
list_seller_refunds(access_token: str, begin_time: int, end_time: int, type: Optional[int] = None, page_size: int = 20, current_page: Optional[int] = None, sort: Optional[int] = None, query_type: Optional[int] = None, negotiate_status: Optional[int] = None, pcursor: Optional[str] = None, status: Optional[int] = None, option: Optional[RefundPageOption] = None, order_id: Optional[int] = None, uid: Optional[int] = None) -> SellerOrderRefundPcursorListResponse
async
获取卖家订单退款分页列表
OpenAPI: open.seller.order.refund.pcursor.list (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundPcursorListRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundPcursorListRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
begin_time
|
int
|
开始时间戳（毫秒） |
必需 |
end_time
|
int
|
结束时间戳（毫秒） |
必需 |
type
|
Optional[int]
|
退款单类型 |
None
|
page_size
|
int
|
页面大小 |
20
|
current_page
|
Optional[int]
|
当前页码 |
None
|
sort
|
Optional[int]
|
排序方式 |
None
|
query_type
|
Optional[int]
|
查询类型 |
None
|
negotiate_status
|
Optional[int]
|
协商状态 |
None
|
pcursor
|
Optional[str]
|
分页游标 |
None
|
status
|
Optional[int]
|
状态 |
None
|
option
|
Optional[RefundPageOption]
|
分页选项 |
None
|
order_id
|
Optional[int]
|
订单ID |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundPcursorListResponse |
SellerOrderRefundPcursorListResponse
|
卖家订单退款分页结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
get_seller_refund_detail(access_token: str, refund_id: int, uid: Optional[int] = None) -> SellerOrderRefundDetailResponse
async
获取卖家订单退款详情
OpenAPI: open.seller.order.refund.detail (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundDetailRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundDetailRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundDetailResponse |
SellerOrderRefundDetailResponse
|
退款详情 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
apply_entry(access_token: str, refund_id: int, desc: str, pictures: Optional[List[str]] = None, status: int = 0, uid: Optional[int] = None) -> SellerOrderRefundApplyEntryResponse
async
卖家退款申请入口
OpenAPI: open.seller.order.refund.apply.entry (POST) Java: com.kuaishou.merchant.open.api.request.KsMerchantRefundApplyEntryRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/KsMerchantRefundApplyEntryRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
desc
|
str
|
申请描述 |
必需 |
pictures
|
Optional[List[str]]
|
图片URL列表 |
None
|
status
|
int
|
状态 |
0
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundApplyEntryResponse |
SellerOrderRefundApplyEntryResponse
|
申请入口结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
post_apply_entry(access_token: str, refund_id: int, desc: Optional[str] = None, pictures: Optional[List[str]] = None, status: int = 0, post_apply_judge_reason: Optional[int] = None, uid: Optional[int] = None) -> SellerOrderRefundPostApplyEntryResponse
async
卖家退款售后申诉入口
OpenAPI: open.seller.order.refund.post.apply.entry (POST) Java: com.kuaishou.merchant.open.api.request.KsMerchantRefundPostApplyEntryRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/KsMerchantRefundPostApplyEntryRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
desc
|
Optional[str]
|
申诉描述 |
None
|
pictures
|
Optional[List[str]]
|
申诉图片URL列表 |
None
|
status
|
int
|
状态 |
0
|
post_apply_judge_reason
|
Optional[int]
|
申诉判定原因 |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundPostApplyEntryResponse |
SellerOrderRefundPostApplyEntryResponse
|
申诉入口结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
disagree_refund(access_token: str, refund_id: int, seller_disagree_reason: int, seller_disagree_desc: Optional[str] = None, seller_disagree_images: Optional[List[str]] = None, status: int = 0, negotiate_status: Optional[int] = None, uid: Optional[int] = None) -> SellerOrderRefundDisagreeResponse
async
卖家不同意退款
OpenAPI: open.seller.order.refund.disagree.refund (POST) Java: com.kuaishou.merchant.open.api.request.KsMerchantRefundDisagreeRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/KsMerchantRefundDisagreeRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
seller_disagree_reason
|
int
|
不同意原因编码 |
必需 |
seller_disagree_desc
|
Optional[str]
|
不同意说明 |
None
|
seller_disagree_images
|
Optional[List[str]]
|
不同意凭证图片URL列表 |
None
|
status
|
int
|
状态 |
0
|
negotiate_status
|
Optional[int]
|
协商状态 |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundDisagreeResponse |
SellerOrderRefundDisagreeResponse
|
处理结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
get_evidence_history(access_token: str, refund_id: int, uid: Optional[int] = None) -> SellerOrderRefundEvidenceHistoryResponse
async
退款证据历史
OpenAPI: open.seller.order.refund.evidence.history (GET) Java: com.kuaishou.merchant.open.api.request.KsMerchantRefundEviHistoryRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/KsMerchantRefundEviHistoryRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundEvidenceHistoryResponse |
SellerOrderRefundEvidenceHistoryResponse
|
证据历史记录 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
get_fee_detail(access_token: str, refund_id: int, uid: Optional[int] = None) -> SellerOrderRefundFeeDetailResponse
async
退款费用明细
OpenAPI: open.seller.order.refund.fee.detail (GET) Java: com.kuaishou.merchant.open.api.request.KsMerchantRefundFeeDetailRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/KsMerchantRefundFeeDetailRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundFeeDetailResponse |
SellerOrderRefundFeeDetailResponse
|
费用明细 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
get_history(access_token: str, refund_id: int, uid: Optional[int] = None) -> SellerOrderRefundHistoryResponse
async
退款历史
OpenAPI: open.seller.order.refund.history (GET) Java: com.kuaishou.merchant.open.api.request.KsMerchantRefundHistoryRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/KsMerchantRefundHistoryRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundHistoryResponse |
SellerOrderRefundHistoryResponse
|
历史记录 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
approve_seller_refund(access_token: str, refund_id: int, refund_amount: int, status: int, desc: Optional[str] = None, negotiate_status: Optional[int] = None, refund_handing_way: Optional[int] = None, uid: Optional[int] = None) -> SellerOrderRefundApproveResponse
async
卖家订单退款审批
OpenAPI: open.seller.order.refund.approve (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundApproveRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundApproveRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
refund_amount
|
int
|
审批的退款金额（分） |
必需 |
status
|
int
|
审批状态码 |
必需 |
desc
|
Optional[str]
|
审批描述（可选） |
None
|
negotiate_status
|
Optional[int]
|
协商状态（可选） |
None
|
refund_handing_way
|
Optional[int]
|
退款处理方式（可选） |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundApproveResponse |
SellerOrderRefundApproveResponse
|
审批结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
approve_return_goods(access_token: str, refund_id: int, refund_amount: int, address_id: int, uid: Optional[int] = None) -> SellerOrderRefundReturngoodsApproveResponse
async
卖家订单退货审批
OpenAPI: open.seller.order.refund.returngoods.approve (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundReturngoodsApproveRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundReturngoodsApproveRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
refund_amount
|
int
|
审批的退款金额（分） |
必需 |
address_id
|
int
|
退货地址ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundReturngoodsApproveResponse |
SellerOrderRefundReturngoodsApproveResponse
|
审批结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
confirm_receipt(access_token: str, refund_id: int, status: int, return_freight_handling_advice: Optional[int] = None, return_freight_amount: Optional[int] = None, return_freight_reject_desc: Optional[str] = None, return_freight_reject_images: Optional[List[str]] = None, uid: Optional[int] = None) -> SellerOrderRefundConfirmReceiptResponse
async
卖家订单退款确认收货
OpenAPI: open.seller.order.refund.confirm.receipt (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundConfirmReceiptRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundConfirmReceiptRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
status
|
int
|
确认收货状态码 |
必需 |
return_freight_handling_advice
|
Optional[int]
|
退货运费处理建议（可选） |
None
|
return_freight_amount
|
Optional[int]
|
退货运费金额（分，可选） |
None
|
return_freight_reject_desc
|
Optional[str]
|
退货运费拒绝描述（可选） |
None
|
return_freight_reject_images
|
Optional[List[str]]
|
退货运费拒绝图片列表（可选） |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundConfirmReceiptResponse |
SellerOrderRefundConfirmReceiptResponse
|
确认结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
同步售后服务
kwaixiaodian.client.services.refund.SyncRefundService(client: SyncBaseClient)
同步售后服务
提供退款退货、协商处理、售后状态查询等功能。
初始化售后服务
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
client
|
SyncBaseClient
|
同步基础客户端实例 |
必需 |
方法：
| 名称 | 描述 |
|---|---|
list |
获取卖家退款单分页列表（游标分页） |
get |
获取卖家退款详情 |
reject |
拒绝退款 |
direct_refund |
直接退款 |
list_refund_comments |
获取退款评论列表 |
list_refund_basic_comments |
获取退款基本评论列表 |
get_reject_reason |
获取拒绝原因 |
add_evidence |
添加退款证据 |
confirm_and_send |
确认并发送退货 |
submit_return_info |
提交退货信息 |
list_seller_refunds |
获取卖家订单退款分页列表 |
get_seller_refund_detail |
获取卖家订单退款详情 |
apply_entry |
卖家退款申请入口 |
post_apply_entry |
卖家退款售后申诉入口 |
disagree_refund |
卖家不同意退款 |
get_evidence_history |
退款证据历史 |
get_fee_detail |
退款费用明细 |
get_history |
退款历史 |
approve_seller_refund |
卖家订单退款审批 |
approve_return_goods |
卖家订单退货审批 |
confirm_receipt |
卖家订单退款确认收货 |
Functions
list(access_token: str, begin_time: int, end_time: int, refund_status: Optional[RefundStatus] = None, refund_type: Optional[int] = None, page_size: int = 20, pcursor: Optional[str] = None, uid: Optional[int] = None) -> SellerOrderRefundPcursorListResponse
获取卖家退款单分页列表（游标分页）
OpenAPI: open.seller.order.refund.pcursor.list (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundPcursorListRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundPcursorListRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
begin_time
|
int
|
开始时间戳（毫秒） |
必需 |
end_time
|
int
|
结束时间戳（毫秒） |
必需 |
refund_status
|
Optional[RefundStatus]
|
退款单状态过滤（可选） |
None
|
refund_type
|
Optional[int]
|
退款类型（可选） |
None
|
page_size
|
int
|
页面大小 |
20
|
pcursor
|
Optional[str]
|
分页游标（可选） |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundPcursorListResponse |
SellerOrderRefundPcursorListResponse
|
卖家退款单分页列表结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
get(access_token: str, refund_id: int, uid: Optional[int] = None) -> SellerOrderRefundDetailResponse
获取卖家退款详情
OpenAPI: open.seller.order.refund.detail (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundDetailRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundDetailRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundDetailResponse |
SellerOrderRefundDetailResponse
|
退款详情 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
reject(access_token: str, refund_id: int, reason_code: Optional[int] = None, reject_desc: Optional[str] = None, reject_images: Optional[List[str]] = None, refund_version: Optional[int] = None, edit_handling_way: Optional[int] = None, edit_return_address_id: Optional[int] = None, uid: Optional[int] = None) -> RefundRejectResponse
拒绝退款
OpenAPI: open.refund.reject (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundRejectRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundRejectRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
reason_code
|
Optional[int]
|
拒绝原因编码（可选） |
None
|
reject_desc
|
Optional[str]
|
拒绝说明（可选） |
None
|
reject_images
|
Optional[List[str]]
|
拒绝凭证图片URL列表（可选） |
None
|
refund_version
|
Optional[int]
|
退款版本号（可选） |
None
|
edit_handling_way
|
Optional[int]
|
处理方式（可选） |
None
|
edit_return_address_id
|
Optional[int]
|
退货地址ID（可选） |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundRejectResponse |
RefundRejectResponse
|
拒绝退款结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
direct_refund(access_token: str, refund_id: int, refund_version: int, uid: Optional[int] = None) -> RefundDirectResponse
直接退款
OpenAPI: open.refund.direct.refund (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundDirectRefundRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundDirectRefundRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
refund_version
|
int
|
退款版本号 |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundDirectResponse |
RefundDirectResponse
|
直接退款结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
list_refund_comments(access_token: str, refund_id: int, uid: Optional[int] = None) -> RefundCommentListResponse
获取退款评论列表
OpenAPI: open.refund.comment.list (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundCommentListRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundCommentListRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundCommentListResponse |
RefundCommentListResponse
|
退款评论列表 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
list_refund_basic_comments(access_token: str, refund_id: int, uid: Optional[int] = None) -> RefundCommentBasicListResponse
获取退款基本评论列表
OpenAPI: open.refund.comment.basic.list (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundCommentBasicListRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundCommentBasicListRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundCommentBasicListResponse |
RefundCommentBasicListResponse
|
退款基本评论列表 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
get_reject_reason(access_token: str, refund_id: int, uid: Optional[int] = None) -> RefundRejectReasonResponse
获取拒绝原因
OpenAPI: open.refund.reject.reason (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundRejectReasonRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundRejectReasonRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundRejectReasonResponse |
RefundRejectReasonResponse
|
拒绝原因详情 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
add_evidence(access_token: str, refund_id: int, image_data: List[str], content: str, uid: Optional[int] = None) -> RefundEvidenceAddResponse
添加退款证据
OpenAPI: open.refund.evidence.add (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundEvidenceAddRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundEvidenceAddRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
image_data
|
List[str]
|
证据图片数据列表 |
必需 |
content
|
str
|
证据描述内容 |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundEvidenceAddResponse |
RefundEvidenceAddResponse
|
添加证据的处理结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
confirm_and_send(access_token: str, refund_id: int, express_no: str, express_code: int, uid: Optional[int] = None) -> RefundConfirmAndSendResponse
确认并发送退货
OpenAPI: open.refund.confirm.and.send (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundConfirmAndSendRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundConfirmAndSendRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
express_no
|
str
|
快递单号 |
必需 |
express_code
|
int
|
快递公司代码 |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundConfirmAndSendResponse |
RefundConfirmAndSendResponse
|
确认并发送退货的结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
submit_return_info(access_token: str, refund_id: int, express_no: str, express_code: int, uid: Optional[int] = None) -> RefundSubmitReturnInfoResponse
提交退货信息
OpenAPI: open.refund.submit.returnInfo (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenRefundSubmitReturninfoRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenRefundSubmitReturninfoRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
express_no
|
str
|
快递单号 |
必需 |
express_code
|
int
|
快递公司代码 |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
RefundSubmitReturnInfoResponse |
RefundSubmitReturnInfoResponse
|
提交退货信息的结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
list_seller_refunds(access_token: str, begin_time: int, end_time: int, type: Optional[int] = None, page_size: int = 20, current_page: Optional[int] = None, sort: Optional[int] = None, query_type: Optional[int] = None, negotiate_status: Optional[int] = None, pcursor: Optional[str] = None, status: Optional[int] = None, option: Optional[RefundPageOption] = None, order_id: Optional[int] = None, uid: Optional[int] = None) -> SellerOrderRefundPcursorListResponse
获取卖家订单退款分页列表
OpenAPI: open.seller.order.refund.pcursor.list (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundPcursorListRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundPcursorListRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
begin_time
|
int
|
开始时间戳（毫秒） |
必需 |
end_time
|
int
|
结束时间戳（毫秒） |
必需 |
type
|
Optional[int]
|
退款类型（可选） |
None
|
page_size
|
int
|
页面大小 |
20
|
current_page
|
Optional[int]
|
当前页码（可选） |
None
|
sort
|
Optional[int]
|
排序方式（可选） |
None
|
query_type
|
Optional[int]
|
查询类型（可选） |
None
|
negotiate_status
|
Optional[int]
|
协商状态（可选） |
None
|
pcursor
|
Optional[str]
|
分页游标（可选） |
None
|
status
|
Optional[int]
|
状态（可选） |
None
|
option
|
Optional[RefundPageOption]
|
分页选项（可选） |
None
|
order_id
|
Optional[int]
|
订单ID（可选） |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundPcursorListResponse |
SellerOrderRefundPcursorListResponse
|
卖家订单退款分页结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
get_seller_refund_detail(access_token: str, refund_id: int, uid: Optional[int] = None) -> SellerOrderRefundDetailResponse
获取卖家订单退款详情
OpenAPI: open.seller.order.refund.detail (GET) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundDetailRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundDetailRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundDetailResponse |
SellerOrderRefundDetailResponse
|
退款详情 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
apply_entry(access_token: str, refund_id: int, desc: str, pictures: Optional[List[str]] = None, status: int = 0, uid: Optional[int] = None) -> SellerOrderRefundApplyEntryResponse
卖家退款申请入口
OpenAPI: open.seller.order.refund.apply.entry (POST) Java: com.kuaishou.merchant.open.api.request.KsMerchantRefundApplyEntryRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/KsMerchantRefundApplyEntryRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
desc
|
str
|
申请描述 |
必需 |
pictures
|
Optional[List[str]]
|
图片URL列表（可选） |
None
|
status
|
int
|
状态（可选） |
0
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundApplyEntryResponse |
SellerOrderRefundApplyEntryResponse
|
申请入口结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
post_apply_entry(access_token: str, refund_id: int, desc: Optional[str] = None, pictures: Optional[List[str]] = None, status: int = 0, post_apply_judge_reason: Optional[int] = None, uid: Optional[int] = None) -> SellerOrderRefundPostApplyEntryResponse
卖家退款售后申诉入口
OpenAPI: open.seller.order.refund.post.apply.entry (POST) Java: com.kuaishou.merchant.open.api.request.KsMerchantRefundPostApplyEntryRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/KsMerchantRefundPostApplyEntryRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
desc
|
Optional[str]
|
申诉描述（可选） |
None
|
pictures
|
Optional[List[str]]
|
申诉图片URL列表（可选） |
None
|
status
|
int
|
状态（可选） |
0
|
post_apply_judge_reason
|
Optional[int]
|
申诉判定原因（可选） |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundPostApplyEntryResponse |
SellerOrderRefundPostApplyEntryResponse
|
申诉入口结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
disagree_refund(access_token: str, refund_id: int, seller_disagree_reason: int, seller_disagree_desc: Optional[str] = None, seller_disagree_images: Optional[List[str]] = None, status: int = 0, negotiate_status: Optional[int] = None, uid: Optional[int] = None) -> SellerOrderRefundDisagreeResponse
卖家不同意退款
OpenAPI: open.seller.order.refund.disagree.refund (POST) Java: com.kuaishou.merchant.open.api.request.KsMerchantRefundDisagreeRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/KsMerchantRefundDisagreeRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
seller_disagree_reason
|
int
|
不同意原因编码 |
必需 |
seller_disagree_desc
|
Optional[str]
|
不同意说明（可选） |
None
|
seller_disagree_images
|
Optional[List[str]]
|
不同意凭证图片URL列表（可选） |
None
|
status
|
int
|
状态（可选） |
0
|
negotiate_status
|
Optional[int]
|
协商状态（可选） |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundDisagreeResponse |
SellerOrderRefundDisagreeResponse
|
不同意退款结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
get_evidence_history(access_token: str, refund_id: int, uid: Optional[int] = None) -> SellerOrderRefundEvidenceHistoryResponse
退款证据历史
OpenAPI: open.seller.order.refund.evidence.history (GET) Java: com.kuaishou.merchant.open.api.request.KsMerchantRefundEviHistoryRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/KsMerchantRefundEviHistoryRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundEvidenceHistoryResponse |
SellerOrderRefundEvidenceHistoryResponse
|
退款证据历史记录 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
get_fee_detail(access_token: str, refund_id: int, uid: Optional[int] = None) -> SellerOrderRefundFeeDetailResponse
退款费用明细
OpenAPI: open.seller.order.refund.fee.detail (GET) Java: com.kuaishou.merchant.open.api.request.KsMerchantRefundFeeDetailRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/KsMerchantRefundFeeDetailRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundFeeDetailResponse |
SellerOrderRefundFeeDetailResponse
|
退款费用明细 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
get_history(access_token: str, refund_id: int, uid: Optional[int] = None) -> SellerOrderRefundHistoryResponse
退款历史
OpenAPI: open.seller.order.refund.history (GET) Java: com.kuaishou.merchant.open.api.request.KsMerchantRefundHistoryRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/KsMerchantRefundHistoryRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundHistoryResponse |
SellerOrderRefundHistoryResponse
|
退款历史记录 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
approve_seller_refund(access_token: str, refund_id: int, refund_amount: int, status: int, desc: Optional[str] = None, negotiate_status: Optional[int] = None, refund_handing_way: Optional[int] = None, uid: Optional[int] = None) -> SellerOrderRefundApproveResponse
卖家订单退款审批
OpenAPI: open.seller.order.refund.approve (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundApproveRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundApproveRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
refund_amount
|
int
|
审批的退款金额（分） |
必需 |
status
|
int
|
审批状态码 |
必需 |
desc
|
Optional[str]
|
审批描述（可选） |
None
|
negotiate_status
|
Optional[int]
|
协商状态（可选） |
None
|
refund_handing_way
|
Optional[int]
|
退款处理方式（可选） |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundApproveResponse |
SellerOrderRefundApproveResponse
|
审批结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
approve_return_goods(access_token: str, refund_id: int, refund_amount: int, address_id: int, uid: Optional[int] = None) -> SellerOrderRefundReturngoodsApproveResponse
卖家订单退货审批
OpenAPI: open.seller.order.refund.returngoods.approve (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundReturngoodsApproveRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundReturngoodsApproveRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
refund_amount
|
int
|
审批的退款金额（分） |
必需 |
address_id
|
int
|
退货地址ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundReturngoodsApproveResponse |
SellerOrderRefundReturngoodsApproveResponse
|
审批结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
confirm_receipt(access_token: str, refund_id: int, status: int, return_freight_handling_advice: Optional[int] = None, return_freight_amount: Optional[int] = None, return_freight_reject_desc: Optional[str] = None, return_freight_reject_images: Optional[List[str]] = None, uid: Optional[int] = None) -> SellerOrderRefundConfirmReceiptResponse
卖家订单退款确认收货
OpenAPI: open.seller.order.refund.confirm.receipt (POST) Java: com.kuaishou.merchant.open.api.request.refund.OpenSellerOrderRefundConfirmReceiptRequest (java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/refund/OpenSellerOrderRefundConfirmReceiptRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
refund_id
|
int
|
退款单ID |
必需 |
status
|
int
|
确认收货状态码 |
必需 |
return_freight_handling_advice
|
Optional[int]
|
退货运费处理建议（可选） |
None
|
return_freight_amount
|
Optional[int]
|
退货运费金额（分，可选） |
None
|
return_freight_reject_desc
|
Optional[str]
|
退货运费拒绝描述（可选） |
None
|
return_freight_reject_images
|
Optional[List[str]]
|
退货运费拒绝图片列表（可选） |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
SellerOrderRefundConfirmReceiptResponse |
SellerOrderRefundConfirmReceiptResponse
|
确认结果 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出。 |
售后数据模型
kwaixiaodian.models.refund
售后（退款退货）相关数据模型
类：
Classes
RefundItem
Bases: BaseModel
退款商品信息
属性：
| 名称 | 类型 | 描述 |
|---|---|---|
unit_yuan |
float
|
单价（元） |
refund_yuan |
float
|
退款金额（元） |
Attributes
unit_yuan: float
property
单价（元）
refund_yuan: float
property
退款金额（元）
RefundOrder
Bases: BaseModel
退款单信息
属性：
| 名称 | 类型 | 描述 |
|---|---|---|
total_refund_yuan |
float
|
总退款金额（元） |
actual_refund_yuan |
float
|
实际退款金额（元） |
is_return_required |
bool
|
是否需要退货 |
is_completed |
bool
|
退款是否完成 |
Attributes
total_refund_yuan: float
property
总退款金额（元）
actual_refund_yuan: float
property
实际退款金额（元）
is_return_required: bool
property
是否需要退货
is_completed: bool
property
退款是否完成