chargebee/laravel-react-starter-kit

Laravel Starter Kit for Billing with Chargebee.

v1.0.2 2025-04-25 16:02 UTC

Requires

• php: ^8.2
• chargebee/cashier: v1.0.0
• dompdf/dompdf: ^3.1
• inertiajs/inertia-laravel: ^2.0
• laravel/framework: ^12.0
• laravel/tinker: ^2.10.1
• tightenco/ziggy: ^2.4

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/pail: ^1.2.2
• laravel/pint: ^1.18
• laravel/sail: ^1.41
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• pestphp/pest: ^3.7
• pestphp/pest-plugin-laravel: ^3.1

MIT

• framework
• laravel

README

Quickly set up billing in your Laravel application using Chargebee.

Introduction

You can watch the below video for a quick video introduction of this starter kit and the Laravel Cashier for Chargebee package used in this starter kit.

Getting Started

Installation

Run the following command in your terminal:

laravel new --using=chargebee/laravel-react-starter-kit

Then, navigate to your project folder:

cd your-project-name

Environment Configuration

• Fill in the Chargebee-related .env variables (see .env.example).
• ⚠️ Important: Run the server on port 8080 or 8443 for Chargebee checkout to work. You can do this by addingSERVER_PORT=8080 in .env file.

Initial Setup

Synchronizing Plans

Fetch your plans from Chargebee:

php artisan chargebee:fetch-plans

Webhook Configuration

Set up a webhook using either of these options:

Using Ngrok

Here is a short tutorial on getting started with Ngrok.

If ngrok gives you a URL like https://{abc}.ngrok-free.app, set your webhook URL as:
🔗 https://{abc}.ngrok-free.app/chargebee/webhook

Using Cloudflare Tunnel

Here is a short tutorial on how to configure tunnel on Cloudflare to test webhook.

If Cloudflare Tunnel gives you a URL like https://{your-tunnel-name}.trycloudflare.com, set your webhook URL as:
🔗 https://{your-tunnel-name}.trycloudflare.com/chargebee/webhook

Note: Don't forget to add this webhook URL in your Chargebee dashboard.

Running Your Application

Start the application using:

composer run dev