Download the PHP package tijmen-wierenga/laravel-chargebee without Composer

LaravelChargebee

A Laravel package which provides an easy way to handle billing and subscriptions by making use of Chargebee's subscription software.

Introduction

LaravelChargebee (LC) is a membership management tool which handles your billing and recurring subscriptions with minimal effort. This easy-to-install package will cover the most important features for a successful subscription system:

• Create recurring subscriptions in a very flexible way:
  • Add add-ons, coupons or even one-time charges
• Change existing subscriptions
• Cancel subscriptions
• All of this through a fluent API or by using Chargebee's secure hosted pages.

Install

If you haven't got an account on Chargebee, create one here.

Then require the package into your project via Composer:

Next, register the service provider in config/app.php:

Add the LaravelChargebee traits to your model:

If you want to use the package's routes for handling webhooks, make sure you place the service provider before the Route Service Prodiver (App\Providers\RouteServiceProvider::class).

Next, run the following command in your terminal:

This will copy and run the migrations necessary for the package to work. It also copies the configuration file to your config path.

There are also a few environment variables that need to be added to the .env-file:

If you want to use a different payment gateway, define your payment gateway details in the .env-file:

Usage

Creating a new subscription:

You can create subscriptions in multiple ways:

• Through Chargebee's Hosted Page
• Through Stripe/Braintree's Javascript library

Create a subscription with Chargebee's Hosted Page

Retrieve a hosted page URL:

The $embed variable is a boolean value which describes whether or not you want to embed the hosted page as an i-frame.

You can now choose between redirecting the user to the hosted page, or send it to a view where you can render it:

Redirect

Return it as a variable in your view

Next, render it in your view:

You can fully customize your hosted page on Chargebee, an example is shown below:

On success, Chargebee will redirect to their own success page by default, but to register the subscription in our own application, we need to redirect back to our application. To define this redirect, setup a callback route:

Add the route and make a call to the registerFromHostedPage method from the controller:

The subscription is now registered in both Chargebee and your own application. I coulnd't be easier!

Example

Subscription Controller

Subscriptions with Stripe/Braintree

In order to create subscriptions with Stripe and Braintree, you need to make use of their Javascript libraries. More info on subscribing with Stripe and Braintree can be found below:

• Stripe
• Braintree

To create a subscription with Braintree or Stripe you'll have to add a credit card token:

You can also add add-ons to a subscription:

Or redeem a coupon:

Changing plans

Cancelling a subscription

Testing

If you want to run the unit tests for this package you need acquire test tokens from Stripe. To be able to fetch a test token create an .env-file in the base directory and add your stripe secret token:

To run the PHPUnit tests, run the following composer command from the base directory:

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• Tijmen Wierenga

License

The MIT License (MIT). Please see License File for more information.