Laravel Development: How to handle subscription payments using Laravel Cashier?

In the Internet era, the subscription model has become one of the major business models. Many companies can achieve a more stable revenue stream through a subscription model. Laravel Cashier provides a convenient way to handle subscription payments.

Laravel Cashier is a Laravel component created by Taylor Otwell, which can assist developers in processing Stripe-based subscription payments. Stripe is a popular online payment service that provides secure, flexible and powerful payment processing capabilities. In this article, we will explain how to use Laravel Cashier to handle subscription payments in a Laravel project.

1. Install Laravel Cashier

First, we need to install Laravel Cashier using composer. Run the following command in the terminal to complete the installation:

composer require laravel/cashier

2. Configure Stripe API Key

Next, we need to configure the Stripe API key in the Laravel project. After creating an account on the Stripe website, you can find the Stripe API key under the "API" menu. Open the config/services.php file and add the following code:

'stripe' => [
    'key' => env('STRIPE_KEY'),
    'secret' => env('STRIPE_SECRET'),
],

This configuration file stores the Stripe API key in the .env file. Make sure the .env file contains the following content:

STRIPE_KEY=your_stripe_key
STRIPE_SECRET=your_stripe_secret

3. Create Subscription Plans

After creating subscription plans on the Stripe website, we need to add these plans to the Laravel application so that they can be used as payment options. Open the app/Providers/AppServiceProvider.php file and add the following code:

use LaravelCashierCashier;

public function boot()
{
    Cashier::useSubscriptionModel(YourSubscriptionModel::class);
    Cashier::useCurrency('usd', '$');
    Cashier::usePlans([
        'monthly' => [
            'name' => 'Monthly Subscription',
            'description' => 'Monthly subscription',
            'price' => 10,
        ],
        'yearly' => [
            'name' => 'Yearly Subscription',
            'description' => 'Yearly subscription',
            'price' => 50,
        ],
    ]);
}

This code block contains two key elements: The first element defines your subscription using the subscription model, which you need to create as your app's part; the second element defines your subscription plan and is used to create and display all available subscription options.

4. Subscriptions and Payments

Now we can create subscriptions for users in the web application. Laravel Cashier provides several convenient methods that allow us to easily manage user subscriptions:

// 为用户创建订阅
$user->newSubscription('main', 'monthly')->create($token);

// 获取用户当前订阅
$user->subscription('main');

// 取消用户订阅
$user->subscription('main')->cancel();

// 恢复用户订阅
$user->subscription('main')->resume();

// 对用户订阅进行切换
$user->subscription('main')->swap('yearly');

In the above code example, we first create a new subscription for the user using the newSubscription() method, which The first parameter of the method specifies the subscription name, and the second parameter specifies the plan name. We then use the create() method to handle the payment, passing a Stripe token as a parameter. We can also use the subscription() method to perform other operations such as getting, canceling, restoring and switching user subscriptions.

5. Display subscription information

Finally, we can display the user's current subscription information on their profile page. Here is a simple code example:

@if ($user->subscribed('main'))
    <p><b>Plan:</b> {{ $user->subscription('main')->stripe_plan }}</p>
    <p><b>Renewal Date:</b> {{ $user->subscription('main')->ends_at->toFormattedDateString() }}</p>
@endif

This code block contains a simple conditional statement that checks whether the user is subscribed to the application. If the user is already subscribed, we can display the user's plan name and renewal date.

Summary

In this article, we covered how to use Laravel Cashier to handle subscription payments. First, we installed Laravel Cashier and configured the Stripe API key. We then created several subscription plans and replaced the ones built into Laravel Cashier with them. Next, we use some methods for users to create, cancel, and resume subscriptions. Finally, we display the user's current subscription information on their profile page. I hope this article is helpful to you. If you have any questions or suggestions, please leave them in the comment area below.

The above is the detailed content of Laravel Development: How to handle subscription payments using Laravel Cashier?. For more information, please follow other related articles on the PHP Chinese website!