travoltron/cashier-extras

Adding the missing features to the fantastic Laravel Cashier package

cashier-extras

![Software License][ico-license] , _(*1)

Install

Via Composer, _(*2)

``` bash $ composer require travoltron/cashier-extras, <sub>(*3)</sub>

Add the following to `config/app.php`:

`Travoltron\CashierExtras\CashierExtrasServiceProvider::class,`

## Usage

This package adds a few interactive CLI tools to make working with Stripe and Laravel's Cashier package a little bit easier. For now it supports creating, listing, and deleting both Stripe Plans and Coupons. 

The Laravel Cashier package documentation states that to run it's own suite of tests, some plans and a coupon need to be added to your Stripe account. 

The added commands are as follows:

###Cashier Testing

``` bash
php artisan cashier:test-data

This adds the needed plans and coupons for Laravel Cashier testing., <sub>(*4)</sub>

Check Stripe Keys

``` bash php artisan stripe:check-keys, <sub>(*5)</sub>

This checks that the `.env` file has been populated with the correct keys and checks at a very loose level that the keys are correctly formatted.

###Stripe Plans

``` bash
php artisan stripe:list-plans

Displays a table of the plans currently enabled on your Stripe account., <sub>(*6)</sub>

``` bash php artisan stripe:make-plan, <sub>(*7)</sub>

Interactive wizard to create a plan via the CLI.

``` bash
php artisan stripe:delete-plan {id}

Deletes a plan with the supplied id. To see this ID, list the plans, and select the value from the first column., <sub>(*8)</sub>

Stripe Coupons

``` bash php artisan stripe:list-coupons, <sub>(*9)</sub>

Displays a table of the coupons currently enabled on your Stripe account.

``` bash
php artisan stripe:make-coupon

Interactive wizard to create a coupon via the CLI., <sub>(*10)</sub>

``` bash php artisan stripe:delete-coupon {id}, <sub>(*11)</sub>

Deletes a coupon with the supplied id. To see this ID, list the coupons, and select the value from the first column.

##Caveats 

By default, the `config/services.php` file has a section for Stripe setup like so:

``` php
'stripe' => [
    'model' => App\User::class,
    'key' => env('STRIPE_KEY'),
    'secret' => env('STRIPE_SECRET'),
],

In order to check for the keys being set properly, change this to: php 'stripe' => [ 'model' => App\User::class, 'key' => env('STRIPE_KEY', env('STRIPE_TEST_KEY')), 'secret' => env('STRIPE_SECRET', env('STRIPE_TEST_SECRET')), ],, <sub>(*12)</sub>

and add the keys STRIPE_TEST_KEY and STRIPE_TEST_SECRET to your .env file., <sub>(*13)</sub>

Change log

Please see CHANGELOG for more information what has changed recently., <sub>(*14)</sub>

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*15)</sub>

Security

If you discover any security related issues, please email ben@travoltron.com instead of using the issue tracker., <sub>(*16)</sub>

Credits

• Ben Warburton
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*17)</sub>