通用场景
创建售后
公共请求参数
业务请求参数
out_aftersale_id｜商家自定义售后id必选string(64)
【描述】商家自定义售后id
【示例值】45665657565656
path｜页面或订单的path必选string(512)
【描述】商家小程序该售后单的页面path或者订单详情页面path，优先传入售后单页面path。
【示例值】/pages/index/index?orderid=10190608609185
type｜售后类型必选string(12)
【描述】售后类型
【枚举值】
退款: refund
退货: return
【示例值】return
以下参数 二选一 传入必选
order_id｜订单idstring(128)
【描述】订单id
【示例值】2024040201502300000005550003822893
out_order_id｜商家自定义订单idstring(64)
【描述】由商家自定义，64个字符以内，仅支持字母、数字、下划线且需保证在商户端不重复。
order_id、out_order_id，二选一
【示例值】20150320010101001
以下参数 二选一 传入必选
user_id｜用户的uidstring(32)
【描述】用户的uid（与openid二选一）
新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看openid配置申请。
【示例值】2088502498476555
open_id｜用户的openidstring(128)
【描述】用户的openid 详情可查看 openid简介
【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
refund_amount｜售后单退款金额可选price(10)
【描述】售后单退款金额，单位：元，精确到小数点后两位。发起实物商品的售后时需要传入
【示例值】1.00
refund_reason｜退款原因可选string(512)
【描述】退款原因
【示例值】商品不喜欢
item_infos｜退换商品的信息可选aftersaleiteminfodto[]
【描述】退换商品的信息
out_item_id｜外部商品id必选string(128)
【描述】外部商品id
【示例值】12345
out_sku_id｜外部skuid必选string(128)
【描述】外部skuid
【示例值】45645664532456545
item_cnt｜商品数量必选string(64)
【描述】商品数量
【示例值】5
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.order.aftersale.create&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={
"order_id":"2024040201502300000005550003822893",
"out_order_id":"20150320010101001",
"open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
"user_id":"2088502498476555",
"out_aftersale_id":"45665657565656",
"refund_amount":"1.00",
"path":"/pages/index/index?orderid=10190608609185",
"type":"return",
"refund_reason":"商品不喜欢",
"item_infos":[
{
"out_sku_id":"45645664532456545",
"out_item_id":"12345",
"item_cnt":"5"
}
]
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
aftersale_id｜平台售后id必选string(34)
【描述】平台售后id
【示例值】2023111601502300000001570009043736
out_aftersale_id｜外部售后单号可选string(64)
【描述】外部售后单号
【示例值】1323545645645
响应示例
正常示例
异常示例
{
"alipay_open_mini_order_aftersale_create_response": {
"code": "10000",
"msg": "success",
"aftersale_id": "2023111601502300000001570009043736",
"out_aftersale_id": "1323545645645"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| mrch_order_error | 订单处理错误 | 订单中心异常，进行重试 |
| order_id_not_exist | 订单号不存在 | 检查订单id是否正确 |
| order_status_error | 订单状态错误，请检查订单状态是否支持该操作 | 请检查订单状态是否支持该操作 |
| out_order_id_invalidate | 商户订单号无效 | 检查商户订单号是否正确 |
| status_invalid | 状态非法，当前订单状态不支持创建售后单 | 检查订单状态，看当前订单状态是否支持创建售后单 |