通用场景
商家售后处理结果同步
公共请求参数
业务请求参数
aftersale_id｜售后单id必选string[1,128]
【描述】交易组件售后单id
【示例值】2015042321001004720200028594
action_code｜操作code必选string[1,10]
【描述】操作code
【枚举值】
商家同意退货申请: 201
商家拒绝退货申请: 202
买家已退货: 203
【示例值】201
以下参数 二选一 传入必选
order_id｜交易组件订单号string[1,128]
【描述】交易组件订单号
【示例值】2015042321001004720200028594
out_order_id｜商户订单号string[1,64]
【描述】商户订单号，创建订单时由商户传入
【示例值】6823789339978248
以下参数 二选一 传入必选
user_id｜买家支付宝用户idstring[1,32]
【描述】买家支付宝用户id，小程序场景下获取用户id请参考：用户授权; 其它场景下获取用户id请参考：网页授权获取用户信息。
新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看openid配置申请。
【示例值】2088***
open_id｜用户openidstring[1,128]
【描述】买家open_id；open_id和user_id二选一 详情可查看 openid简介
【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
audit_reason｜售后审核原因条件必选string[1,256]
【描述】售后审核原因。
【必选条件】当传入action_code，且action_code=202,205,102时必选
【示例值】用户已确认收货，不同意售后退款请求。
merchant_address_info｜商家地址条件必选aftersaleaddressinfodto
【描述】商家地址
【必选条件】当传入action_code，且action_code=201时必选
user_name｜联系人姓名必选string[1,20]
【描述】联系人姓名
【示例值】小明
phone_number｜电话号码必选string[1,20]
【描述】电话号码
【示例值】132********
area｜区县必选string[1,64]
【描述】区县
【示例值】西湖区
province｜省份必选string[1,64]
【描述】省份
【示例值】浙江省
city｜城市地级市必选string[1,64]
【描述】城市
【示例值】杭州市
detail｜详细地址必选string[1,200]
【描述】详细地址
【示例值】浙江省杭州市西湖区西溪路569号
merchant_agree_refund_amount｜商家实际同意退款的金额条件必选string[1,32]
【描述】商家实际同意退款的金额（元）
【必选条件】当传入action_code,且action_code=101时必选
【示例值】2
logistics_list｜物流信息条件必选array
【描述】物流信息，action_code为203时必填
【必选条件】当传入action_code,且action_code=203时必选
delivery_id｜快递公司id必选string[1,32]
【描述】快递公司id,
请确认传入的值在此列表内，若发货的快递公司不在此列表内，可以传入值other
【示例值】32
waybill_id｜快递单号必选string[1,32]
【描述】快递单号
【示例值】2343455
out_refund_request_no_list｜商家退款成功的外部退款单号可选array[0,20]
【描述】商家退款成功的外部退款单号,对应alipay.trade.refund(统一收单交易退款接口)的out_request_no
【示例值】["2222222"]
return_delivery_type｜退货物流类型可选string[1,100]
【描述】退货寄送方式
action_code为201时可选填入,
不传入的情况下使用商家自行接入的售后物流能力。
【枚举值】
支付宝上门取件: alipay_home_pickup
【示例值】alipay_home_pickup
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.order.aftersale.sync&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":"2015042321001004720200028594",
"out_order_id":"6823789339978248",
"aftersale_id":"2015042321001004720200028594",
"user_id":"2088***",
"open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
"audit_reason":"用户已确认收货，不同意售后退款请求。",
"action_code":"201",
"merchant_address_info":{
"area":"西湖区",
"province":"浙江省",
"city":"杭州市",
"user_name":"小明",
"phone_number":"132********",
"detail":"浙江省杭州市西湖区西溪路569号"
},
"merchant_agree_refund_amount":"2",
"out_refund_request_no_list":[
"2222222"
],
"logistics_list":[
{
"delivery_id":"32",
"waybill_id":"2343455"
}
],
"return_delivery_type":"alipay_home_pickup"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_mini_order_aftersale_sync_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| invalid_action_code | 非法的售后单操作code | 请检查action_code取值 |
| merchant_order_status_illegal | 同步状态非法 | 同步状态非法,请检查操作类型action_code和当前售后单状态 |
| mrch_order_error | 订单处理错误 | 订单处理错误 |
| order_id_is_null | 订单id为空 | 请传入正确的订单id |
| order_is_null | 订单id和外部订单id都为空 | 订单id和外部订单id请传入任一 |
| out_order_id_invalidate | 外部订单号不匹配 | 请确认外部订单号与商户是否匹配 |
| out_order_id_is_null | 商户订单号为空 | 商户订单号不为空 |