用途:该技能封装 Paystack Settlements API,用于查看和追踪 Paystack 向银行账户的放款(结算),并进行对账。依赖 paystack-setup 提供的 paystackRequest 辅助方法。
主要能力:提供两个接口。GET /settlement 列出结算,可带 perPage(默认 50)、page(默认 1)、status(success、processing、pending、failed)、subaccount(子账户 ID,或 none 表示仅主账户)、from、to 等参数;GET /settlement/:id/transactions 列出某笔结算包含的具体交易,支持 perPage 与 page。结算状态含义:success 已成功入账,processing 处理中,pending 排队中,failed 失败。
使用方式:调用 paystackRequest,例如列出某区间成功结算:paystackRequest("/settlement?status=success&from=2024-01-01&to=2024-01-31");仅主账户:paystackRequest("/settlement?subaccount=none");指定子账户:paystackRequest("/settlement?subaccount=ACCT_6uujpqtzmnufzkw");查询结算交易:paystackRequest(/settlement/${settlementId}/transactions?perPage=50&page=1)。返回字段含 id、status、currency、total_amount、effective_amount、total_fees、total_processed、settlement_date,交易含 id、status、reference、amount、channel、currency、paid_at。金额以最小货币单位表示(如 100 表示 1 单位,示例中 /100 换算)。
对账模式:先按日期与状态拉取结算,再逐笔查询其交易,输出总额与净额及交易数量,可用于核对账目。
限制:需先具备 paystack-setup 与 paystackRequest;交易 ID 需按无符号 64 位整数存储,避免精度丢失;其他费率、权限、平台与错误处理细节暂未提供。