商户通过分账接口对下单时请求分账的交易进行分账。
注意:
(1)如果分给收单商户自身,仍需主动调用分账接口,并传递具体的分账信息(splitDetails)。如果不调用分账接口,未分账的资金将始终处于挂起状态,不会自动结算给收单商户;
(2)商户出款未开通时不可跨商户分账。
https://apis.5upay.com/split/order
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一id,可在商户后台查看 | M |
requestId | 分账订单号 | varchar(50) | 商户自行定义的分账订单号,不可重复。 | M |
partnerId | 服务商 id | varchar(9) | 服务商在首信易系统的唯一id,可在商户后台查看 | C |
orderId | 原交易订单号 | varchar(50) | 此项传订单交易完成以后的requestId | M |
totalSplitAmount | 分账金额 | varchar(20) | 单位:分,可填写正整数、-1,填写“-1”时为剩余未分账金额全额分账,仅可填写一条分账明细信息 | M |
notifyUrl | 通知地址 | varchar(200) | 服务器通知:订单成功后会向该地址发送五次成功通知,该地址可以带参数,如: “https://www.5upay.com/callback.action?test=test”. | M |
splitDetails | 分账信息 | Json(数组) | 分账信息,见下表 | M |
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
subSplitRequestId | 分账明细订单号 | varchar(13) | 分账明细订单号,商户自行拟定,不可重复。 | M |
splitAccType | 分账类型 | 固定值 | MERCHANT_ACC 商户 | M |
WALLET_ACC 钱包 | ||||
splitAccId | 分账方编号 | varchar(30) | 分账类型为商户时此参数传商户的merchantId(可传主商户商编) | M |
分账类型为钱包时此参数传用户的walletId | ||||
splitAmount | 分账明细订单金额 | varchar(20) | 单位:分,可填写正整数、-1,填写“-1”时为剩余未分账金额全额分账,仅可填写一条分账明细信息 | M |
remark | 分账备注 | varchar(300) | 分账备注 | M |
注意:订单分账请求中分账明细记录数最多10条
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 同请求参数 |
requestId | 分账订单号 | 同请求参数 |
partnerId | 服务商 id | 同请求参数 |
orderId | 原交易订单号 | 首信易支付原交易订单号 |
status | 请求状态 | SUCCESS 成功 |
FAILED 失败 | ||
ERROR 错误 | ||
errorMessage | 错误信息 | 错误信息 |
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 同请求参数 |
requestId | 分账订单号 | 同请求参数 |
partnerId | 服务商 id | 同请求参数 |
splitAmount | 分账金额 | 单位:分,1 元=100 分 |
subSplitRequestId | 分账明细订单号 | 同请求参数 |
splitStatus | 分账状态 | INIT 处理中 |
FINISHED 已完成 | ||
status | 明细分账状态 | SUCCESS 成功 |
completeDateTime | 明细分账完成时间 | 格式:yyyy-MM-dd HH:mm:ss |
remark | 备注 | 备注 |
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |
注意:
1、每笔分账明细订单处理完成后都会发异步通知;
2、发异步通知时,若还有分账明细未处理完成,则通知参数splitStatus的值为“INIT”,表示订单分账还在处理中;
3、发异步通知时,若所有的分账明细均已处理完成,则通知参数splitStatus的值为“FINISHED”,表示订单分处理完成
4、每笔分账明细处理完成后,系统单独发异步通知,不能保证商户收到通知的顺序与处理分账明细的顺序一致;