Skip to content
laravel-stripe-connect logo

Laravel Stripe Connect

laravel-stripe-connect

Build marketplaces and platforms with Stripe Connect. Use when implementing multi-vendor payments, seller onboarding, commissions, payouts, or split payments.

SKILL.md

Full skill instructions

Laravel Stripe Connect

Agent Workflow (MANDATORY)

Before ANY implementation, launch in parallel:

  1. fuse-ai-pilot:explore-codebase - Check existing payment setup, Seller model
  2. fuse-ai-pilot:research-expert - Verify latest Stripe Connect docs via Context7
  3. mcp__context7__query-docs - Query specific patterns (account types, payment flows)

After implementation, run fuse-ai-pilot:sniper for validation.


Overview

Stripe Connect enables platforms and marketplaces to accept payments and pay out sellers/​service providers.

Use CaseExampleThis Skill
MarketplaceEtsy, eBay✅ Yes
On-demand servicesUber, DoorDash✅ Yes
CrowdfundingKickstarter✅ Yes
SaaS with payoutsSubstack, Teachable✅ Yes
Simple SaaSNetflix, Notion❌ Use billing

Key Difference: Billing vs Connect

AspectLaravel CashierStripe Connect
Money flowCustomer → YouCustomer → Seller (via you)
Accounts1 Stripe accountPlatform + N seller accounts
Use caseSubscriptionsMulti-party payments
ComplexitySimpleComplex

Critical Rules

  1. Verify seller identity - KYC required before payouts
  2. Handle negative balances - Platform liable if seller can't cover refunds
  3. Webhook-driven - Never trust client-side for payment confirmation
  4. Store account IDs - Always persist stripe_account_id on sellers
  5. Test with test mode - Use test account IDs before production
  6. Understand liability - Know who pays for disputes per account type

Architecture

app/
├── Http/
│   ├── Controllers/
│   │   └── Connect/
│   │       ├── SellerOnboardingController.php
│   │       ├── MarketplacePaymentController.php
│   │       └── PayoutController.php
│   └── Middleware/
│       └── EnsureSellerOnboarded.php
├── Models/
│   ├── Seller.php              ← Connected account holder
│   └── Transaction.php         ← Payment records
├── Listeners/
│   └── ConnectWebhookHandler.php
└── Services/
    └── StripeConnectService.php

config/
└── services.php                ← Stripe keys

routes/
└── web.php                     ← Webhook routes (no CSRF)

Decision Guide

Which Account Type?

Who handles customer support?
├── Seller handles everything → Standard
├── Platform handles support → Express or Custom
│   ├── Need full UI control? → Custom
│   └── Want Stripe's dashboard? → Express (recommended)

Which Payment Flow?

Who appears on customer's bank statement?
├── Seller's name → Direct charges
├── Platform's name → Destination charges (recommended)
└── Complex split? → Separate charges + transfers

Key Concepts

ConceptDescriptionReference
Connected AccountSeller's Stripe account linked to platformaccount-types.md
OnboardingKYC process for sellersonboarding.md
Application FeePlatform's commission on paymentsfees-commissions.md
Destination ChargePayment with automatic transfer to sellerpayment-flows.md
PayoutTransfer from Stripe balance to bankpayouts.md

Reference Guide

Concepts (WHY & Architecture)

TopicReferenceWhen to Consult
Overviewoverview.mdUnderstanding Connect fundamentals
Account Typesaccount-types.mdChoosing Standard/​Express/​Custom
Payment Flowspayment-flows.mdDirect vs Destination vs Transfers
Onboardingonboarding.mdSeller verification process
Fees & Commissionsfees-commissions.mdPlatform revenue model
Payoutspayouts.mdPaying sellers
Refunds & Disputesrefunds-disputes.mdHandling chargebacks
Compliancecompliance.mdLegal and tax requirements

Templates (Complete Code)

TemplateWhen to Use
Seller.php.mdSeller model with Connect integration
SellerOnboardingController.php.mdOAuth and onboarding flow
MarketplacePaymentController.php.mdCreating charges with fees
PayoutController.php.mdManaging seller payouts
ConnectWebhookHandler.php.mdWebhook event handling
ConnectRoutes.php.mdRoute definitions

Quick Reference

Create Connected Account

$account = \Stripe\Account::create([
    'type' => 'express',
    'country' => 'FR',
    'email' => $seller->email,
    'capabilities' => [
        'card_payments' => ['requested' => true],
        'transfers' => ['requested' => true],
    ],
]);

$seller->update(['stripe_account_id' => $account->id]);

Create Onboarding Link

$link = \Stripe\AccountLink::create([
    'account' => $seller->stripe_account_id,
    'refresh_url' => route('connect.onboarding.refresh'),
    'return_url' => route('connect.onboarding.complete'),
    'type' => 'account_onboarding',
]);

return redirect($link->url);

Destination Charge with Fee

$payment = \Stripe\PaymentIntent::create([
    'amount' => 10000, // €100.00
    'currency' => 'eur',
    'payment_method' => $paymentMethodId,
    'confirm' => true,
    'application_fee_amount' => 1500, // €15.00 platform fee
    'transfer_data' => [
        'destination' => $seller->stripe_account_id,
    ],
]);

Check Account Status

$account = \Stripe\Account::retrieve($seller->stripe_account_id);

$isOnboarded = $account->charges_enabled && $account->payouts_enabled;
$needsInfo = !empty($account->requirements->currently_due);

Best Practices

DO

  • Use Express accounts for most marketplaces
  • Implement webhook handlers for all Connect events
  • Store transaction records locally
  • Handle account.updated to track onboarding status
  • Use idempotency keys for payment creation
  • Test with Stripe CLI and test clocks

DON'T

  • Enable payouts before KYC completion
  • Ignore negative balance scenarios
  • Skip webhook signature verification
  • Hardcode Stripe account IDs
  • Forget to handle dispute notifications
  • Process refunds without checking seller balance

More skills from majiayu000

xiaohongshu logo
majiayu000/claude-arsenal

xiaohongshu

xiaohongshu

286 148
View
agent-task-conductor logo
majiayu000/claude-skill-registry

agent-task-conductor

Conduct multi-agent task orchestration and workflow coordination.

663 1
View
conductor-setup logo
majiayu000/claude-skill-registry

conductor-setup

Initialize project with Conductor artifacts (product definition,

663 1
View
animation-designer logo
majiayu000/claude-skill-registry

animation-designer

Expert in web animations, transitions, and motion design using Framer Motion and CSS

663 1
View
diagramming logo
majiayu000/claude-skill-registry

diagramming

Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...

663 1
View
h3-pg logo
majiayu000/claude-skill-registry-data

h3-pg

PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.

23 1
View
conductor-development logo
majiayu000/claude-skill-registry

conductor-development

Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...

663 1
View
conductor-status logo
majiayu000/claude-skill-registry

conductor-status

Display project status, active tracks, and next actions

663 1
View
dockerization logo
majiayu000/claude-skill-registry

dockerization

Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.

663 1
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View