通用场景
交易组件业务单修改
公共请求参数
业务请求参数
以下参数 二选一 传入必选
out_order_id｜商家自定义订单号string[1,64]
【描述】由商家自定义，64个字符以内，仅支持字母、数字、下划线且需保证在商户端不重复。
【示例值】20150320010101001
order_id｜交易组件订单号string[28,34]
【描述】交易组件订单号
【示例值】2023032501502300000001520000019936
以下参数 可选 传入
user_id｜蚂蚁统一会员idstring[1,32]
【描述】蚂蚁统一会员id
新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看openid配置申请。
【示例值】2088401374030307
open_id｜用户openidstring[1,128]
【描述】用户openid 详情可查看 openid简介
【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
price_info｜订单价格信息可选priceinfomodifydto
【描述】订单价格修改信息
order_price｜订单总金额可选string[1,9]
【描述】订单金额，单位：元
【示例值】11.12
item_infos｜商品信息可选[0,50]
【描述】商品修改信息
out_item_id｜商家商品id必选string[1,64]
【描述】提报商品库的商品
【示例值】123
out_sku_id｜商家商品skuid条件必选string[1,64]
【描述】提报商品库的商品
【必选条件】sku维度的商品该字段必传
【示例值】123
rent_info｜租金信息可选rentinfodto
【描述】商品租赁信息
rent_start_time｜租期开始时间条件必选date
【描述】租期开始时间
匹配格式yyyy-mm-dd hh:mm:ss的date类型
【必选条件】在创建订单接口的情况下，订单模型类型为standard_rent必填
【示例值】2023-11-01 12:00:00
rent_end_time｜租期结束时间条件必选date
【描述】租期结束时间
匹配格式yyyy-mm-dd hh:mm:ss的date类型
【必选条件】在创建订单接口的情况下，订单模型类型为standard_rent必填
【示例值】2023-11-01 12:00:00
buyout_price｜买断价可选string[1,100]
【描述】到期买断金，支持到期买断场景，回传到期买断金；单位：元，精确到小数点后两位；
【示例值】2000.00
stage_pay_plans｜阶段付款计划可选array
【描述】阶段付款计划列表，请在修改付款计划时传入
stage_no｜阶段编码必选number[1,36]
【描述】阶段付款计划阶段编号，标识当前计划处于第几阶段，起始值为1，多阶段需保证阶段编号递增
【示例值】1
stage_pay_plan_infos｜计划信息列表必选array
【描述】阶段付款计划详情列表
plan_pay_no｜计划付款编号必选number[1,36]
【描述】阶段计划付款编号，标识第几次或第几期付款，起始值为1，多个计划需保证编号递增
【示例值】1
plan_pay_price｜计划付款金额必选price[0,10000000]
【描述】阶段付款计划付款金额，单位：元，精确到小数点后两位
【示例值】100.00
plan_pay_time｜计划付款时间必选date
【描述】阶段付款计划付款时间，多个计划需保证付款时间递增
匹配格式yyyy-mm-dd hh:mm:ss的date类型
【示例值】2024-04-10 12:00:00
plan_buyout_price｜计划买断金额可选price[0,10000000]
【描述】计划买断金额，支持随时买断场景；回传当期买断金，当期买断金=当期买断价-截止到当期已支付租金；单位：元，精确到小数点后两位；
【示例值】100.00
alloc_amount_info｜分账条款可选allocamountinfodto
【描述】分账条款
invest_id｜资方id必选string[1,32]
【描述】资方pid，对应合作融资的资方pid
【示例值】20884******0307
rent_royalty_details｜分账明细可选array
【描述】租金分账明细
【注意事项】royalty_type传rent
stage_no｜阶段号必选number[1,32]
【描述】阶段号，举例1、2、3.......
【示例值】1
royalties｜分账计划必选array
【描述】每个阶段对应的分账计划
royalty_price｜分账金额必选string[1,8]
【描述】分账金额，举例50.00 单位：元，精确到小数点后两位
【示例值】50.00
royalty_type｜分账类型必选string[1,32]
【描述】分账金类型，目前仅支持：
rent(租金分账)、buyout(买断分账)
【枚举值】
租金: rent
买断金: buyout
【示例值】buyout
buy_out_price｜买断分账金必选price[0,1000000]
【描述】对应这一期买断分账金，不能超过当期买断金，单位：元，精确到小数点后两位；
【示例值】100.00
royalty_period｜分账期数条件必选number[1,48]
【描述】租金分账期数，举例1、2、3.....
【必选条件】当传入royalty_type,且royalty_type = rent时必选
【示例值】1
buy_out_royalty｜买断分账计划可选royaltydto
【描述】买断分账计划
【注意事项】royalty_type传buyout
royalty_price｜分账金额必选string[1,8]
【描述】分账金额，举例50.00 单位：元，精确到小数点后两位
【示例值】50.00
royalty_type｜分账类型必选string[1,32]
【描述】分账金类型，目前仅支持：
rent(租金分账)、buyout(买断分账)
【枚举值】
租金: rent
买断金: buyout
【示例值】buyout
buy_out_price｜买断分账金必选price[0,1000000]
【描述】对应这一期买断分账金，不能超过当期买断金，单位：元，精确到小数点后两位；
【示例值】100.00
royalty_period｜分账期数条件必选number[1,48]
【描述】租金分账期数，举例1、2、3.....
【必选条件】当传入royalty_type,且royalty_type = rent时必选
【示例值】1
sub_merchant｜二级商户信息可选submerchantmodifydto
【描述】二级商户信息
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.order.modify&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={
"out_order_id":"20150320010101001",
"order_id":"2023032501502300000001520000019936",
"user_id":"2088401374030307",
"open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
"price_info":{
"order_price":"11.12"
},
"item_infos":[
{
"out_sku_id":"123",
"out_item_id":"123",
"rent_info":{
"buyout_price":"2000.00",
"rent_start_time":"2023-11-01 12:00:00",
"rent_end_time":"2023-11-01 12:00:00"
}
}
],
"stage_pay_plans":[
{
"stage_no":1,
"stage_pay_plan_infos":[
{
"plan_pay_time":"2024-04-10 12:00:00",
"plan_buyout_price":"100.00",
"plan_pay_no":1,
"plan_pay_price":"100.00"
}
]
}
],
"alloc_amount_info":{
"invest_id":"20884******0307",
"buy_out_royalty":{
"royalty_period":1,
"royalty_price":"50.00",
"buy_out_price":"100.00",
"royalty_type":"buyout"
},
"rent_royalty_details":[
{
"royalties":[
{
"royalty_period":1,
"royalty_price":"50.00",
"buy_out_price":"100.00",
"royalty_type":"buyout"
}
],
"stage_no":1
}
]
},
"sub_merchant":{}
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_mini_order_modify_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| installment_buyer_out | 订单已买断，不允许更新订单 | 订单已买断，不允许更新订单 |
| item_not_exist | 商品不存在 | 请检查商品id是否正确 |
| mrch_order_error | 订单处理错误 | 请填写正确的订单修改信息 |
| order_has_closed | 订单已经关闭，不允许更新订单 | 订单已经关闭，不允许更新订单 |
| order_id_not_exist | 订单id不存在 | 请填写正确的订单id |
| order_status_is_finished | 订单已经完结，不允许更新订单 | 订单已经完结，不允许更新订单 |