Creating a Subscription-Based Website with Laravel and Recurly, Part 2

This tutorial continues building a subscription-based website using Laravel and Recurly. Part 1 established the basic website structure, user roles, and registration. This part integrates Recurly for payment processing and subscription management.

Key Features:

• Secure payment processing using Recurly's PHP client library and Recurly.js. Sensitive data remains on Recurly's servers.
• Creation and management of multiple subscription plans (Bronze, Silver, Gold) within Recurly, with customizable pricing, setup fees, and trial periods.
• User registration and payment integration via Laravel routes and views, leveraging Recurly.js for secure payment form handling.
• Dynamic role assignment based on subscription status, managed by Laravel's session management and role system.
• Account management features, including billing updates, integrated with Recurly's API for a secure and streamlined user experience.

Setup:

1. Recurly.js Integration: Include recurly.min.js (from the Recurly.js build folder) in your Laravel application's public/js/libs directory and link it in your layout. Similarly, add the Recurly CSS theme to your public/css/recurly/themes/default directory and link it in your layout.

2. Recurly Account Configuration: Create subscription plans (Bronze, Silver, Gold) in your Recurly account, noting their plan codes ("bronze", "silver", "gold"). Enable API access and Recurly.js, recording your API key, private key, and subdomain. Create a recurly.php configuration file in app/config/recurly.php containing these credentials and your default currency (e.g., 'GBP').

3. Push Notifications: Configure Recurly push notifications, setting the notification URL to your-app-url/recurly.

Signup Page (app/views/home/signup.blade.php):

This page displays the available subscription plans. Consider fetching plan details dynamically from the Recurly API for up-to-date pricing. Links direct users to plan-specific registration routes (/user/register/bronze, etc.). Custom CSS styles are provided to enhance the plan display.

Payment Processing:

1. Modified Registration Callback: The user registration callback now redirects to a payment page (/user/register/payment) after creating the user account, storing the user in the session.

2. Payment Route (/user/register/payment): This route generates a Recurly.js signature using the user's ID and selected plan. It passes this signature and other necessary data to the payment view (user/register.blade.php).

3. Payment View (app/views/user/register.blade.php): This view contains a div with the ID "recurly-subscribe" where Recurly.js will inject the payment form. JavaScript code initializes Recurly.js, builds the subscription form using the server-side generated signature, and specifies success and failure URLs.

4. Confirmation Callback (/user/register/confirm): This route receives the Recurly token after successful payment. It uses the Recurly library to fetch subscription details, assigns the appropriate role to the user, and removes the pending role.

Account Management:

Protected routes (/user/account, /user/account/billing) allow logged-in users to manage their account. The billing page uses Recurly.js to generate a billing information update form, similar to the signup payment process. A confirmation callback handles updates.

Push Notifications (/recurly):

This route handles Recurly push notifications. The example provided shows how to process a canceled_subscription_notification, revoking the user's role. Other notification types can be handled similarly.

Frequently Asked Questions (FAQs):

The provided FAQs cover common aspects of integrating Recurly with Laravel for subscription management, including handling different plans, renewals, failed payments, cancellations, refunds, discounts, and multi-tenancy. These answers give a comprehensive overview of the process.

The above is the detailed content of Creating a Subscription-Based Website with Laravel and Recurly, Part 2. For more information, please follow other related articles on the PHP Chinese website!