二级分账及二级分账退款接口


二级分账接口

接口说明:

1.仅单订单担保确认接口支持二级分账

2.二级分账列表的分账会员角色必须符合行业版角色管控记录的分账会员角色

3.二级分账记录可在云商通二代或云梯门户的订单管理-订单查询的订单详情里进行查看

4.原交易为二级分账的交易,退款时需要退二级分账则传入二级分账数据,不上送二级分账退款的列表,则默认从一级分账方退款;

单订单担保确认

receiverList 收款人列表 JSONArray 单订单担保确认收款人列表,详情

单订单担保确认收款人列表

名称 类型 说明 是否必填
signNum String 商户会员编号。 
amount Long 金额,单位:分
couponAmount Long 平台抽佣金额,单位:分;内扣,如金额=100,平台抽佣金额=2,实际到账金额为98
sepDetail JSONArray 仅一级分账场景使用
支持分账到会员。
secDivSepDetail JSONArray 同时存在一二级分账场景使用,详情

二次分账规则列表secDivSepDetail

名称 类型 说明 是否必填
signNum String 一级分账会员
商户系统用户标识。
amount Long 金额,单位:分
remark String 备注,最长50个字符
sepDetail JSONArray 一级分账会员的二级分账规则列表
内扣。 支持分账到会员。

示例:

//只有一级分账人时上送 sepDetail
{
    "receiverList": [{
        "signNum": "A",
        "amount": "100",
        "couponAmount": 0,
        "sepDetail": [
            {
                "signNum": "A1",
                "amount": "100",
            }
        ]
    }]
}

//同时有一级分账人又有二级分账人时上送secDivSepDetail
{
 "receiverList": [{
         "signNum": "A",
         "amount": "100",
         "couponAmount": 0,
         "secDivSepDetail": [
             {
                 "signNum": "A1",
                 "amount": "100",
                 "sepDetail": [
                     {
                         "signNum": "A11",
                         "amount": "30"
                     },
                     {
                         "signNum": "A12",
                         "amount": "70"
                     }
                 ]
             }
         ]
     }]
}

退款申请

字段 字段类型 必填 字段名称
refundDetail JSONArray 订单退款列表

订单退款列表详情JSON(refundDetail)

字段 字段类型 必填 字段名称
signNum String 商户会员编号
orderAmount Long 退款金额
acctType String 账户类型
sepDetail JSONArray 分账退款列表

分账退款列表详情JSON(sepDetail)

字段 字段类型 必填 字段名称
signNum String 一级分账会员
amount Long 分账退款金额
sepDetail JSONArray 二级分账退款列表,

示例:

//含二级分账退款

         "sepDetail": [
             {
                 "signNum": "A1",
                 "amount": "100",
                 "sepDetail": [
                     {
                         "signNum": "A11",
                         "amount": "30"
                     },
                     {
                         "signNum": "A12",
                         "amount": "70"
                     }
                 ]
             }
         ]


liyz4 2025年6月12日 15:40 收藏文档