通用场景
订单确认收货
注意：
merchant_biz_type为kx_shopping(电商购物)时，只有delivered（已经发货）状态才能进行确认收货。
merchant_biz_type为virtual_recharge(虚拟商品)时，只有delivered（已经发货）状态才能进行确认收货。
其他情况会返回订单状态非法。
merchant_biz_type为virtual_recharge(虚拟商品)时，只有delivered（已经发货）状态才能进行确认收货。
其他情况会返回订单状态非法。
公共请求参数
业务请求参数
以下参数 二选一 传入必选
order_id｜交易组件订单号string[1,128]
【描述】交易组件订单号；order_id和out_order_id二选一
【示例值】2015042321001004720200028594
out_order_id｜商户订单号string[1,64]
【描述】商户订单号，创建订单请求由商户传入；order_id和out_order_id二选一
【示例值】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 详情可查看 openid简介
【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
delivery_receive_list｜物流单列表可选
【描述】确认收货的物流单列表，当有多个物流单时，可以指定物流单确认收货，不传入时，默认进行全部确认收货。
waybill_id｜快递单号条件必选string[1,32]
【描述】快递单号
【必选条件】waybill_id和logistics_order_id二选一传入
【示例值】2343455
logistics_order_id｜物流单id条件必选string[1,128]
【描述】物流单id
【必选条件】logistics_order_id和waybill_id二选一传入
【示例值】2015042321001004720200028594
常见请求示例
推荐示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.order.delivery.receive&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",
"user_id":"2088***",
"open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_mini_order_delivery_receive_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| confirm_need_try_again | 确认收货异常，一小时后重试 | 确认收货异常，一小时后重试 |
| merchant_biz_type_invalidate | 订单模板类型错误 | 请检查订单模版类型是否支持收货 |
| order_center_is_error | 订单中心异常 | 订单中心异常，请填写正确的订单 |
| order_id_is_null | 订单id为空 | 请传入正确的订单id |
| order_id_not_exist | 订单id不存在 | 请传入正确的订单id |
| order_is_not_received | 当前物流运单未送达，无法确认收货 | 对应物流单需要签收状态才能进行确认收货 |
| out_order_id_invalidate | 外部订单号不匹配 | 请确认外部订单号与商户是否匹配 |
| out_order_id_is_null | 商户订单号为空 | 商户订单号不为空 |
| param_is_null | 参数为空 | 参数不为空 |
| parse_json_error | 参数解析有误 | 请检查参数 |
| received_order_is_error | 订单确认失败 | 请确认订单状态 |
| received_order_is_repeat | 订单已重复确认收货 | 订单已重复确认收货,无需重复确认收货 |
| status_invalid | 状态非法 | 请确认订单状态是否满足推进到确认收货状态 |
| user_id_is_null | 用户id为空 | 请传入正确的用户id |