通用场景
用于多阶段订单分期付款后履约确认
公共请求参数
业务请求参数
out_installment_order_id｜外部分期单号必选string[1,64]
【描述】分期单外部请求号。由商家自定义，64个字符以内，仅支持字母、数字、下划线且需保证在商户端不重复。
其他请求参数不变时重复请求会幂等返回分期单号。
【示例值】23232323232323
type｜分期类型必选string[0,32]
【描述】分期类型
【枚举值】
租金: rent
买断: buyout
续租: relet
【注意事项】创建订单如果传入阶段付款计划，改类型不允许传入relet，如果是租金类型请传入rent
【示例值】rent
installment_no_info_list｜分期号信息列表必选array
【描述】分期号信息列表，多期合并主动支付场景传入
stage_no｜分期阶段编码必选number[1,5]
【描述】分期的阶段编码，与创建时的阶段付款计划里的阶段编码对应
【示例值】1
installment_no｜本次分期号必选string[1,34]
【描述】当前分期数
【示例值】1
以下参数 二选一 传入必选
order_id｜交易组件订单号string[1,34]
【描述】交易组件订单号
【示例值】23232323232323
out_order_id｜外部商户订单号string[1,100]
【描述】外部商户订单号
【示例值】12345
以下参数 二选一 传入
user_id｜买家idstring[1,32]
【描述】2088开头的16位纯数字，小程序场景下获取用户id请参考：用户授权; 其它场景下获取用户id请参考：网页授权获取用户信息;
新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看openid配置申请。
【示例值】2088102146225135
open_id｜支付宝用户唯一标识string[1,128]
【描述】支付宝用户唯一标识 详情可查看 openid简介
【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
installment_price｜分期金额条件必选price(0.00,1000000]
【描述】当分期类型为rent，
期数为1时，分期金额=首期金额；
期数非1时，分期金额=每期金额，如果有尾期金额，最后一期分期金额=尾期金额；
当分期类型为buyout，分期金额=买断价 buyout_price；
当分期类型为relet，分期金额即续租金额；
【必选条件】当交易组件订单类型为standard_rent时必传
【示例值】10.00
installment_no_type｜分期号类型条件必选string[1,10]
【描述】分期数类型
【枚举值】
期数: period
【必选条件】当传入installment_no字段时，该字段必填
【示例值】period
installment_no｜本次分期号条件必选string[1,34]
【描述】当前分期数
【必选条件】当分期单类型type=rent或type=withhold时，该字段必填。
【示例值】1
trade_no｜交易号可选string[1,100]
【描述】支付宝收单交易号
【示例值】12345
is_finish_performance｜分期是否完结可选boolean
【描述】分期是否已经完结。
false:未完结
true:已完结
【示例值】true
pay_channel｜分期单支付渠道可选string[1,32]
【描述】用户分期扣款的凯发k8官方网娱乐官方的支付方式
【枚举值】
支付宝支付: alipay
微信支付: wechat
其他: other
【示例值】alipay
stage_no｜分期阶段编码可选number[1,5]
【描述】分期的阶段编码，与创建时的阶段付款计划里的阶段编码对应。
【示例值】1
is_sync_pay｜是否同步主动支付可选boolean
【描述】分期单同步模式请传入true，该模式会直接推进分期单进入结算阶段
【示例值】true
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.order.installment.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":"23232323232323",
"out_order_id":"12345",
"user_id":"2088102146225135",
"open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
"out_installment_order_id":"23232323232323",
"trade_no":"12345",
"is_finish_performance":true,
"type":"rent",
"installment_price":"10.00",
"installment_no_type":"period",
"installment_no":"1",
"pay_channel":"alipay",
"stage_no":1,
"is_sync_pay":true,
"installment_no_info_list":[
{
"stage_no":1,
"installment_no":"1"
}
]
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
installment_order_id必选string(34)
【描述】分期单号。在代扣等场景下使用
【示例值】2015042321001004720200028594
响应示例
正常示例
异常示例
{
"alipay_open_mini_order_installment_create_response": {
"code": "10000",
"msg": "success",
"installment_order_id": "2015042321001004720200028594"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| buyer_account_error | 订单买家信息与分期单中交易号对应的买家信息不一致 | 请确认交易号是否正确 |
| installment_buyer_out | 分期已买断，不能创建分期单 | 分期已买断，不能创建分期单 |
| merchant_relation_invalidate | 无商业关系，不能创建分期单 | 请检查是否已经建立商业关系 |
| mrch_order_error | 订单处理错误 | 创建订单分期失败 |
| order_id_not_exist | 订单不存在 | 请传入正确的订单号 |
| order_merchant_mismatch | 商家订单中的pid和创建分期单的pid不一致。 | 当前订单对应的商家id与小程序不匹配，请传入正确的订单号 |
| status_invalid | 订单状态不正确，不支持创建分期单，请检查订单状态 | 该订单不支持分期 |
| trade_not_exist | 交易不存在 | 请检查交易单号是否正确 |
| trade_status_error | 交易状态错误 | 交易状态错误，请检查传入的支付宝交易号是否支付过 |