通用场景
售后单信息查询
公共请求参数
业务请求参数
以下参数 二选一 传入必选
aftersale_id｜售后单号string[0,64]
【描述】售后单号，和商家自定义售后单号二选一
【示例值】202202300133490202
out_aftersale_id｜商家自定义售后单号string[0,64]
【描述】商家自定义售后单号，和平台售后单号二选一
【示例值】tqshajkk1163937zz
以下参数 二选一 传入必选
user_id｜蚂蚁统一会员idstring[0,32]
【描述】蚂蚁统一会员id
新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看openid配置申请。
【示例值】2088401374030307
open_id｜支付宝用户openidstring[0,128]
【描述】买家open_id，和uid二选一 详情可查看 openid简介
【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.order.aftersale.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"aftersale_id":"202202300133490202",
"out_aftersale_id":"tqshajkk1163937zz",
"user_id":"2088401374030307",
"open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
order_id｜订单号必选string(128)
【描述】交易组件订单号
【示例值】2015042321001004720200028594
out_aftersale_id｜外部售后单号必选string(64)
【描述】外部售后单号
【示例值】1126823789339978248
aftersale_id｜平台售后单号必选string(34)
【描述】平台售后单号
【示例值】2024040101502301800002390004866076
apply_refund_amount｜申请退款金额必选string(11)
【描述】申请退款金额，单位：元,精确到小数点后两位
【示例值】88.88
type｜售后类型必选string(32)
【描述】售后类型
【枚举值】
退款: refund
换货: change
【示例值】refund
action_type｜售后单触发类型必选string(32)
【描述】售后单触发类型
【枚举值】
用户主动退: active
过期自动退: expire
用户投诉: complaint
【示例值】active
status｜售后单状态必选string(32)
【描述】售后单状态
【枚举值】
处理中: processing
已退款: refund_closed
商户拒绝: seller_reject
【示例值】processing
status_code｜售后单状态code必选string(10)
【描述】售后单状态code
【枚举值】
初始化: 1
退款中: 2
已退款: 3
【示例值】1
aftersale_goods_info_list｜商品列表必选aftersaleiteminfo[]
【描述】商品列表
out_item_id｜外部商品id必选string(64)
【描述】外部商品id
【示例值】12345
item_cnt｜商品数量必选string(32)
【描述】商品数量,单位:"个"
【示例值】5
out_sku_id｜外部skuid可选string(64)
【描述】外部skuid
【示例值】1111324242424
finally_refund_amount｜最终退款金额可选string(11)
【描述】最终退款金额，单位：元,精确到小数点后两位
【示例值】88.88
aftersale_media_list｜售后媒体资源列表可选ordermediainfo[]
【描述】用户通过标准售后组件申请售后时，上传的证明图片和视频信息
type｜资源类型必选string(10)
【描述】资源类型
【枚举值】
视频: video
图片: image
【示例值】video
url｜资源访问链接必选string(512)
【描述】资源访问链接地址
【示例值】https://www.alipay.net/file/***
poster_url｜资源封面地址条件必选string(512)
【描述】资源封面地址
【必选条件】当type=video时必选
【示例值】https://www.alipay.net/file/***
aftersale_reason｜售后发起原因可选string(128)
【描述】用户售后发起原因
【示例值】商户未发货
additional_reason｜售后发起补充原因可选string(512)
【描述】创建售后单时用户填写的补充描述
【示例值】物品有损坏
path｜商家小程序售后单页面可选string(256)
【描述】商家小程序售后单页面
【示例值】/pages/index/index?orderid=10190608609185
logistics_waybills｜物流单详情可选logisticswaybill[]
【描述】物流单详情
additional_reason｜售后物流补充原因必选string(512)
【描述】用户自行寄件退货时填写的补充描述
【示例值】物品有损坏
status｜状态必选string(64)
【描述】状态
【示例值】receive_success
waybill_no｜运单号必选string(128)
【描述】运单号
【示例值】502300000001520000140683
logistics_code｜物流公司编号必选string(64)
【描述】物流公司编号
【示例值】sto
steps｜物流详情必选waybillstep[]
【描述】物流详情
city｜城市必选string(64)
【描述】城市
【示例值】杭州
time｜时间必选date(32)
【描述】时间
【示例值】2024-02-24 11:22:42
desc｜描述必选string(256)
【描述】描述
【示例值】包裹已揽收
logistics_media_list｜物流资源列表可选ordermediainfo[]
【描述】用户自行寄回商品时，补充上传的证明图片和视频信息
type｜资源类型必选string(10)
【描述】资源类型
【枚举值】
视频: video
图片: image
【示例值】video
url｜资源访问链接必选string(512)
【描述】资源访问链接地址
【示例值】https://www.alipay.net/file/***
poster_url｜资源封面地址条件必选string(512)
【描述】资源封面地址
【必选条件】当type=video时必选
【示例值】https://www.alipay.net/file/***
return_delivery_type｜退货寄送方式可选string(128)
【描述】退货寄送方式
【枚举值】
支付宝上门取件: alipay_home_pickup
自行寄回: self_return
【示例值】alipay_home_pickup
响应示例
正常示例
异常示例
{
"alipay_open_mini_order_aftersale_query_response": {
"code": "10000",
"msg": "success",
"order_id": "2015042321001004720200028594",
"out_aftersale_id": "1126823789339978248",
"aftersale_id": "2024040101502301800002390004866076",
"apply_refund_amount": "88.88",
"finally_refund_amount": "88.88",
"type": "refund",
"action_type": "active",
"aftersale_media_list": [
{
"type": "video",
"url": "https://www.alipay.net/file/***",
"poster_url": "https://www.alipay.net/file/***"
}
],
"status": "processing",
"aftersale_reason": "商户未发货",
"additional_reason": "物品有损坏",
"path": "/pages/index/index?orderid=10190608609185",
"logistics_waybills": [
{
"logistics_media_list": [
{
"type": "video",
"url": "https://www.alipay.net/file/***",
"poster_url": "https://www.alipay.net/file/***"
}
],
"return_delivery_type": "alipay_home_pickup",
"additional_reason": "物品有损坏",
"status": "receive_success",
"waybill_no": "502300000001520000140683",
"logistics_code": "sto",
"steps": [
{
"city": "杭州",
"time": "2024-02-24 11:22:42",
"desc": "包裹已揽收"
}
]
}
],
"status_code": "1",
"aftersale_goods_info_list": [
{
"out_item_id": "12345",
"out_sku_id": "1111324242424",
"item_cnt": "5"
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| aftersale_out_aftersale_is_null | 售后单id和外部售后单id同时为空 | 请检查参数,售后单id和外部售后单id不能同时为空 |
| user_id_is_null | userid为空 | userid或openid不能同时为空 |