Download the PHP package nguoingulanh/cashier-connect without Composer

Cashier Connect

Stripe Connect for Laravel Cashier (Stripe).

Cashier bills your customers. Cashier Connect pays your sellers: onboarding, connected account status, destination / direct charges, transfers, payouts, refunds and Connect webhooks, without touching Cashier itself.

• Requirements
• Installation
• Connected accounts
• Onboarding
• Taking payments
• Transfers, balance and payouts
• Refunds
• Webhooks
• Events
• Middleware
• Artisan commands
• Testing your application
• Configuration

Requirements

* Laravel 11 no longer receives security fixes. It is still tested for existing applications, but upgrading is recommended.

Installation

Add the printed secret to .env:

That's it. The package reuses Cashier's STRIPE_KEY / STRIPE_SECRET, registers its routes, migrations and commands automatically, and needs no change to your users table. Run php artisan cashier-connect:doctor at any time to check the setup.

Connected accounts

Any Eloquent model can own a connected account: a User, a Shop, a Vendor... Use the facade, or add the optional ConnectBillable trait for shorter calls:

Accounts are Express by default. Pass any Stripe account parameter to change that:

When creating Express or Custom accounts, the package requests the card_payments and transfers capabilities, pre-fills the owner's email and stores the owner in the account metadata. By default a model owns a single account. Set multiple_accounts to true in the config to allow more than one.

Onboarding

Redirect the seller to Stripe-hosted onboarding. The connected account is created first if it does not exist yet:

When the seller comes back, the package syncs the account status and redirects to the URL you passed, or to onboarding.return_url if you passed none. If the Stripe link expired, a new one is issued automatically. The return and refresh URLs are signed, so they work without a session.

Taking payments

Destination charges

The customer pays the platform, and the funds are transferred to the seller. Build the options with destination() and pass them to Cashier:

Other builder methods: ->onBehalfOf() (the seller becomes the merchant of record), ->transferAmount(9000), ->transferGroup('ORDER_1') and ->with([...]) to add any raw parameter.

Direct charges

The payment is created on the connected account itself. onBehalfOf() returns a Stripe client that sends every request on that account:

Transfers, balance and payouts

For separate charges and transfers:

All money-moving methods accept Stripe request options, e.g. ['idempotency_key' => "order-{$order->id}"].

Refunds

Webhooks

Stripe sends connected account events to a dedicated Connect endpoint. php artisan cashier-connect:webhook creates it at /stripe/connect/webhook with these events:

account.updated, account.application.deauthorized, capability.updated, person.updated, payout.paid, payout.failed, payout.canceled

How the endpoint handles events:

• Signatures are verified. Separate several secrets with commas (whsec_old,whsec_new) to rotate a secret without downtime.
• Each event is stored once and its handler runs once, even when Stripe delivers it again.
• The account is re-fetched from Stripe instead of trusting the payload, so events that arrive out of order still leave the correct state.
• If a handler fails, the endpoint answers 500 and Stripe retries. Run php artisan cashier-connect:replay --failed to retry stored failures manually.
• Live endpoints ignore test-mode events from connected accounts.

To process events in the background, set a queue:

Add or override handlers in a service provider:

Platform events. Transfers and application fees happen on your account, so Stripe sends them to Cashier's regular webhook. If you enable transfer.created, transfer.reversed and application_fee.refunded on that endpoint, the package turns them into Connect events as well.

Events

All events live in Nguoingulanh\CashierConnect\Events and carry the local ConnectedAccount ($event->account->connectable is your model).

Middleware

Artisan commands

Testing your application

CashierConnect::fake() swaps Stripe for an in-memory gateway, so your tests make no HTTP calls:

Other helpers: restrict(), setAccount(), failNext('createTransfer'), assertCalled(), assertNotCalled() and calls().

Configuration

Everything works with the defaults. To customise, publish the config:

License

The MIT License (MIT). See LICENSE.