用途:该技能封装 Paystack Transaction Splits API,帮助在支付结算时把款项分配到主账户和一个或多个子账户,比简单的子账户分账更灵活。依赖 paystack-setup 提供 paystackRequest 助手;创建分账所用的子账户可参考 paystack-subaccounts。
主要能力与接口:POST /split 创建分账;GET /split 列表;GET /split/:id 获取单个分账;PUT /split/:id 更新;POST /split/:id/subaccount/add 添加或更新子账户份额;POST /split/:id/subaccount/remove 移除子账户。创建参数包括 name、type(percentage 或 flat)、currency、subaccounts(由 { subaccount, share } 组成的数组)、bearer_type,以及 bearer_type 为 subaccount 时必填的 bearer_subaccount。
手续费承担方式:subaccount 由指定子账户承担;account 由主账户承担全部;all-proportional 按比例分摊;all 各方按各自份额承担。
用法要点:以 percentage 类型创建时,share 表示百分比;以 flat 类型创建时,share 表示固定金额(如 50000 表示 ₦500)。列表接口支持 name、active、sort_by、perPage、page、from、to 过滤。使用分账时,在初始化交易(/transaction/initialize)请求中传入 split_code。
限制:本资料未提供各接口的官方错误码、速率限制、鉴权方式,以及金额的最小单位和具体换算规则,需另行查阅官方文档确认。