创建分期单请求
接口说明
| 接口名称 | installment_order |
|---|---|
| 接口模式 | 直连 |
| 异步通知 | 是 |
应用场景
商家发起扣款时，需先调用本接口创建分期单，再紧接着调用“商家扣款”接口。
- 注意：入参“分期金额”等于扣款交易金额，且不能大于下单时送入的“每期最大金额”
接口参数
- 请求：
| 说明 | 字段 | 类型 | 条件 | 示例值 | 备注 |
|---|---|---|---|---|---|
| 代理商商户号 | agentMerId | S(16) | 否 | 100003789 | 宝付支付分配的商户号 |
| 代理商终端号 | agentTerId | S(16) | 否 | 213003567 | 宝付支付分配的终端号 |
| 交易商户号 | merId | S(16) | 是 | 102002369 | 宝付支付分配的商户号 |
| 交易终端号 | terId | S(16) | 是 | 100003123 | 宝付支付分配的终端号 |
| 子商户商户号 | subMchId | S(64) | 是 | 子商户商户号 | |
| 宝付业务订单号 | componentOrderNo | S(32) | 是 | 创建业务订单时宝付返回的业务订单号 | |
| 商户分期单号 | outInstallmentOrderNo | S(32) | 是 | 商户系统内部业务订单号，同一个商户号下唯一 | |
| 用户标识 | openId | S(128) | 是 | 2088102146225135 | 买家支付宝用户id （2088开头的user_id） |
| 期数 | installmentNum | I | 是 | 1 | 固定值：1 |
| 分期金额 | installmentPrice | I | 是 | 1200 | 单位：【分】，不能大于下单送入的“每期最大金额” |
| 分期是否完结 | finishInstallmentFlag | B | 是 | true | true/false |
| 分期类型 | installmentType | S | 是 | WITHHOLD | 间连先享后付下枚举值：WITHHOLD |
| 交易时间 | txnTime | S(14) | 是 | 20250301103059 | 格式：yyyyMMddHHmmss |
| 请求预留字段 | reqReserved | S(255) | 否 |
- 返回：
| 说明 | 字段 | 类型 | 条件 | 示例值 | 备注 |
|---|---|---|---|---|---|
| 代理商商户号 | agentMerId | S(16) | 否 | 100000 | 宝付支付分配的商户号 |
| 代理商终端号 | agentTerId | S(16) | 否 | 100000 | 宝付支付分配的终端号 |
| 交易商户号 | merId | S(16) | 是 | 宝付支付分配的商户号 | |
| 交易终端号 | terId | S(16) | 是 | 宝付支付分配的终端号 | |
| 宝付分期单号 | installmentOrderNo | S(32) | 是 | 2015042321001004720200028594 | 平台生成，用于扣款 |
| 商户分期单号 | outInstallmentOrderNo | S(32) | 是 | ||
| 分期单状态 | orderState | E | 否 | 详见：【分期订单状态】 | |
| 返回扩展参数 | chlRetParam | C | 否 | JSON格式，会根据业务需求动态添加相应字段属性 | |
| 业务结果 | resultCode | S(16) | 是 | SUCCESS | 业务处理结果 |
| 错误代码 | errCode | S(32) | 否 | 当业务结果FAIL时，返回错误代码 | |
| 错误描述 | errMsg | S(128) | 否 | 当业务结果为FAIL时，返回错误描述 |
作者：admin 创建时间：2025-03-21 18:42
最后编辑：lilizhi 更新时间：2025-06-17 14:16
最后编辑：lilizhi 更新时间：2025-06-17 14:16
