SuperAPI AI 工具集

laravel-stripe-connect

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

用途:在 Laravel 项目中实现多卖家市场支付,覆盖卖家入驻(KYC)、平台佣金、分账收款与向卖家打款。适用于市场平台、按需服务、众筹以及带打款的 SaaS;若只是普通订阅收款,资料建议改用 Billing(Laravel Cashier)。

主要能力:创建 Connected Account、生成入驻链接、创建带 application_fee_amount 的 Destination Charge、查询账户状态与打款、处理退款与争议、Webhook 事件处理。资料提供概念参考(账户类型、支付流程、入驻、费用与佣金、打款、退款与争议、合规)与代码模板(Seller 模型、入驻控制器、市场支付控制器、打款控制器、Webhook 处理器、路由)。

使用方式:资料要求先并行启动三个 Agent(explore-codebase、research-expert、mcp__context7__query-docs),实现后运行 fuse-ai-pilot:sniper 验证。关键代码示例包括:\Stripe\Account::create 创建 express 账户并保存 stripe_account_id;\Stripe\AccountLink::create 生成 account_onboarding 链接并重定向;\Stripe\PaymentIntent::create 设置 amount、currency、payment_method、confirm、application_fee_amount 与 transfer_data.destination;\Stripe\Account::retrieve 检查 charges_enabled、payouts_enabled 与 requirements.currently_due。

选择指南:卖家自行处理客服选 Standard;平台处理客服时,需要完全控制 UI 选 Custom,否则推荐 Express。账单显示卖家名称用 Direct charges,显示平台名称用 Destination charges(推荐),复杂分账用 Separate charges + transfers。

限制与规则:打款前必须完成 KYC;平台需承担卖家无法覆盖退款时的负余额责任;支付确认必须依赖 Webhook,不可信任客户端;必须持久化 stripe_account_id;生产前用测试模式与测试账户;需验证 Webhook 签名并处理争议通知。Laravel 13 下需将 connect/webhook 排除 CSRF,account.updated 处理可用 Context::add 传递账户 ID,PHP 8.3 可用 final readonly class。具体价格、费率与平台支持范围资料未提供。