Download the PHP package lab404/laravel-stripe-server without Composer

Laravel Stripe Server

Laravel Stripe Server is a library to handle Stripe SCA checkout for your models.

• Requirements
• Intended workflow
• Installation
• Going deeper
• Nova
• Ideas
• Tests
• Contribute
• Licence

Requirements

• Laravel 6.x or 7.x
• PHP >= 7.2

Laravel support

Intended workflow

• You have an Order model with a stripe checkout. You create the order in your controller.

Example model:

• Your user is redirected to stripe, he fills his informations and he's redirected to your success URL. The order is not paid yet. Asynchronously, the plugin will try to get new events from Stripe and will dispatch the CheckoutSessionCompleted event:

Example listener:

• You can use your model like this:

Installation

1. Require it with Composer:

2. Configure your Stripe keys in config/services.php.

3. Publish migrations and views with php artisan vendor:publish --tag=stripe-server.

4. Migrate 2019_06_19_101000_create_stripe_checkouts_table.php.

5. Schedule the command in app\Console\Kernel.php:

6. Add the Lab404\StripeServer\Models\HasStripeCheckout or HasStripeCheckouts (if a model can have multiple checkouts) to your chargeable models.

Going deeper

Stripe documentation

• Checkout Server Quickstart
• Checkout Purchase Fulfillment
• Going Live with Checkout
• Strong Customer Authentication

Access the Stripe Manager

With facade:

With DI:

With container:

Available methods

• redirectSession(string $session_id): Illuminate\Contracts\View\View
• registerCheckout(\Stripe\Checkout\Session $session, Model $model): Illuminate\Database\Eloquent\Model
• requestCreateCharge(): StripeServer\Requests\CreateCharge
• requestCreateSession(): StripeServer\Requests\CreateSession
• requestPaymentIntent(string $id): StripeServer\Requests\PaymentIntent
• requestEvents(string $type, int $hours = 24): StripeServer\Requests\Events
• requestSessionCheckoutCompletedEvents(int $hours = 24): StripeServer\Requests\Events

Working with your models

Model with many checkouts

When a model has the Lab404\StripeServer\Models\HasStripeCheckouts you have access to the following methods and scopes:

Model with one checkout

When a model has the Lab404\StripeServer\Models\HasStripeCheckout you have access to the following methods and scopes:

Customize the StripeCheckout model

Configure model in config/stripe-server.php. Your custom model should extend the default one.

Customize the redirector

When you use the redirectSession() method, an instance of Illuminate\View\View is returned. You can do:

Artisan commands

stripe:checkout-session-completed

Get all checkout.session.completed Stripe events and dispatch the event CheckoutSessionCompleted for each with the succeeded status.

stripe:events

Get all Stripe events and dispatch StripeEvent for each one.

stripe:purge

Delete all unpaid StripeCheckout older than the given days. Customize with the --days option, defaults to 7. It's convenient to call it in a scheduler:

Nova

If you're using Laravel Nova you can add the Lab404\StripeServer\Nova\StripeCheckout resource:

This resource is not dynamically registered because it's quite simple and you may want to override it. More Nova features like Refund Action or Cards are coming.

TODOs and ideas

[x] Purge unpaid stripe checkouts
[ ] Refund
[ ] Nova actions

Tests

TODO

Contribute

This package is still in development, feel free to contribute!

Contributors

• MarceauKa
• and all others contributors

Licence

MIT