用途:Paystack Subaccounts API 用于创建和管理子账户(subaccounts),代表接收每笔付款一部分的子商户/供应商,实现主账户与子商户之间的分账。依赖 paystack-setup 提供的 paystackRequest 辅助函数;多方可参与的分账配置参见 paystack-splits。
主要端点:POST /subaccount 创建子账户;GET /subaccount 列出子账户(支持 perPage、page、from、to);GET /subaccount/:id_or_code 获取单个;PUT /subaccount/:id_or_code 更新。
创建参数:business_name(必填)、bank_code 或示例中的 settlement_bank(必填)、account_number(必填)、percentage_charge(必填,主账户从每笔付款中获得的百分比)、description、primary_contact_email、primary_contact_name、primary_contact_phone、metadata。
更新参数:business_name 与 description 为必填,可选 bank_code、account_number、active、percentage_charge、settlement_schedule、联系人与 metadata。结算周期可为 auto(T+1,默认)、weekly、monthly、manual。
用法:在初始化交易时传入 subaccount 代码,并可用 transaction_charge(以子单位计的固定费用,覆盖百分比)和 bearer("account" 或 "subaccount",决定谁承担 Paystack 费用)覆盖。市场平台模式:先为供应商创建子账户,再在收款时传子账户代码。示例中平台抽 10%,供应商得 90% 减去 Paystack 费用。
限制:依赖 paystack-setup;金额以子单位表示;具体收费与其他限制资料未提供。