# Laravel Cashier

[![Build Status](https://travis-ci.org/laravel/cashier.svg)](https://travis-ci.org/laravel/cashier)
[![Total Downloads](https://poser.pugx.org/laravel/cashier/d/total.svg)](https://packagist.org/packages/laravel/cashier)
[![Latest Stable Version](https://poser.pugx.org/laravel/cashier/v/stable.svg)](https://packagist.org/packages/laravel/cashier)
[![Latest Unstable Version](https://poser.pugx.org/laravel/cashier/v/unstable.svg)](https://packagist.org/packages/laravel/cashier)
[![License](https://poser.pugx.org/laravel/cashier/license.svg)](https://packagist.org/packages/laravel/cashier)

## Introduction

Laravel Cashier provides an expressive, fluent interface to [Stripe's](https://stripe.com) subscription billing services. It handles almost all of the boilerplate subscription billing code you are dreading writing. In addition to basic subscription management, Cashier can handle coupons, swapping subscription, subscription "quantities", cancellation grace periods, and even generate invoice PDFs.

## Test Setup
You will need to set the following details locally and on your Stripe account in order to test:

### Local
#### .env
    STRIPE_API_KEY=
    STRIPE_SECRET=

### Stripe
#### Plans
    * monthly-10-1 ($10)
    * monthly-10-2 ($10)
#### Coupons
    * coupon-1 ($5)

## Official Documentation

Documentation for Cashier can be found on the [Laravel website](http://laravel.com/docs/billing).

## Contributing

Thank you for considering contributing to the Cashier. You can read the contribution guide lines [here](contributing.md).

## License

Laravel Cashier is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)
