如何限制Stripe Connect仅查看平台产生的关联账户交易？

核心背景 #

你的电商平台通过Stripe Connect接入供应商后，在Stripe控制台能看到供应商关联账户的全部交易（包括平台外操作），需要仅筛选平台产生的交易。Stripe控制台本身没有直接的内置过滤选项，但可以通过以下方法实现需求：

1. 给平台发起的交易添加专属元数据标记 #

每次在平台上发起支付、转账等操作时，给对应的Stripe对象（如PaymentIntent、Transfer、Charge）添加唯一标识平台来源的元数据，后续通过控制台搜索或API查询过滤这些标记的交易。

示例PHP代码（创建带元数据的PaymentIntent）：

$paymentIntent = \Stripe\PaymentIntent::create([
    'amount' => 1000, // 单位：分
    'currency' => 'usd',
    'transfer_data' => [
        'destination' => '{{CONNECTED_ACCOUNT_ID}}', // 供应商关联账户ID
    ],
    'metadata' => [
        'platform_source' => 'your_ecommerce_platform' // 自定义平台标识
    ]
]);

控制台筛选方法：在Stripe控制台的交易搜索框中输入 metadata[platform_source]:your_ecommerce_platform，即可只显示平台产生的交易。

2. 通过Stripe API自定义查询与展示 #

如果需要更精准的控制，可以开发内部的交易管理页面，直接通过API查询并过滤平台产生的交易，避免依赖Stripe控制台。

示例PHP代码（查询指定供应商的平台交易）：

// 查询该供应商关联账户下，由平台发起的转账记录
$transfers = \Stripe\Transfer::all([
    'destination' => '{{CONNECTED_ACCOUNT_ID}}',
    'metadata[platform_source]' => 'your_ecommerce_platform',
    'limit' => 100 // 按需调整数量
]);

这种方式可以完全自定义展示内容，只呈现平台相关的交易记录。

3. 调整OAuth授权的权限范围（辅助优化） #

检查你的OAuth授权流程，默认可能请求了read_write的全量权限。可以根据实际需求缩小权限范围，比如仅请求read_transfers、read_payment_intents等必要权限。但注意：权限范围主要限制API的访问能力，Stripe控制台仍会显示关联账户的全部交易，因此这只是辅助手段，核心还是依赖元数据标记。

修改后的OAuth授权请求（需在引导供应商授权时指定scope参数）：

// 示例：构造授权URL时指定权限范围
$authorizeUrl = \Stripe\OAuth::authorizeUrl([
    'client_id' => '{{YOUR_PLATFORM_CLIENT_ID}}',
    'scope' => 'read_transfers write_payment_intents', // 按需指定权限
    'redirect_uri' => '{{YOUR_REDIRECT_URI}}',
]);

关键说明 #

Stripe控制台的关联账户视图设计为展示该账户的所有交易，这是因为平台主账户对关联账户拥有访问权限。因此无法直接在控制台隐藏非平台交易，只能通过元数据标记+过滤的方式实现需求，这也是Stripe官方推荐的平台交易区分方案。

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