PHP调用Stripe获取Connect关联账户总余额实现咨询

核心结论 #

available和pending两个字段下确实可能出现多个数组元素，你当前返回只有1个元素，是因为对应Stripe账户目前仅持有英镑（gbp）单一币种的余额。
这两个数组的每个元素对应一个币种的余额数据，元素内的amount是对应币种的最小单位金额（如英镑为便士、美元为美分），currency字段标记对应币种。只要账户后续开通多币种收款、持有其他币种的待结算/可用资金，这两个数组就会返回多个元素，每个元素对应一个币种。

你当前写法的问题 #

$totalBalance = $balance->available[0]->amount + $balance->pending[0]->amount;

这个写法仅在单币种场景下能临时得到正确结果，存在明显风险：

• 一旦账户新增其他币种余额，代码只会取数组第一个元素的金额，漏算其他币种资金，计算结果完全错误
• 即使是单币种场景，Stripe也不保证数组内元素的返回顺序固定，硬编码索引[0]存在取错数据的可能
• 跨币种的amount数值不能直接相加，不同币种的货币单位、汇率均不相同，直接累加得到的数值没有实际财务意义

正确实现方式 #

场景1：业务仅需统计指定单一币种余额 #

不要硬编码数组索引，遍历两个数组匹配目标币种后再计算：

$targetCurrency = 'gbp'; // 替换为你需要统计的目标币种
$availableTotal = 0;
$pendingTotal = 0;

// 统计目标币种可用余额
foreach ($balance->available as $item) {
    if ($item->currency === $targetCurrency) {
        $availableTotal = $item->amount;
        break;
    }
}

// 统计目标币种待结算余额
foreach ($balance->pending as $item) {
    if ($item->currency === $targetCurrency) {
        $pendingTotal = $item->amount;
        break;
    }
}

$totalBalance = $availableTotal + $pendingTotal;

场景2：需要统计全币种余额 #

必须遍历两个数组的所有元素，按币种分别归集金额，不要跨币种直接累加数值：

$balanceSummary = [];

// 归集可用余额
foreach ($balance->available as $item) {
    $currency = $item->currency;
    if (!isset($balanceSummary[$currency])) {
        $balanceSummary[$currency] = [
            'available' => 0,
            'pending' => 0
        ];
    }
    $balanceSummary[$currency]['available'] = $item->amount;
}

// 归集待结算余额
foreach ($balance->pending as $item) {
    $currency = $item->currency;
    if (!isset($balanceSummary[$currency])) {
        $balanceSummary[$currency] = [
            'available' => 0,
            'pending' => 0
        ];
    }
    $balanceSummary[$currency]['pending'] = $item->amount;
}

// 后续可按币种分别计算总余额：单币种总余额 = available + pending

补充说明：每个余额条目下的source_types数组是同币种余额按资金来源（如卡支付、银行转账）的拆分统计，不会影响顶层available/pending数组的元素数量，顶层元素数量仅和账户持有余额的币种数量相关。

内容的提问来源于stack exchange，提问作者Lewis Smith