Recurring PayPage – PHP Ready to Integrate Payment Gateways for Subscriptions

Introduction to Recurring PayPage

Recurring PayPage is a PHP-based payment gateway solution that allows you to integrate various payment gateways with your website to manage recurring subscriptions. It's a powerful tool for e-commerce businesses, subscription-based services, and online membership sites. With Recurring PayPage, you can easily set up and manage recurring payments, invoices, and subscription plans. In this tutorial, we'll walk you through the process of setting up and using Recurring PayPage to integrate a payment gateway with your website.

Setting up Recurring PayPage

Before we dive into the tutorial, make sure you have the following:

• A PHP-based website
• A payment gateway account (e.g., PayPal, Stripe, Authorize.net)
• A Recurring PayPage installation (you can download it from the official website)

Once you have these, follow these steps to set up Recurring PayPage:

1. Extract the Recurring PayPage zip file to a directory on your website (e.g., /recuring-paypage).
2. Create a new database for Recurring PayPage (e.g., recuring_paypage_db) and add the following database credentials to the config.php file:
   • DB_HOST: your database host
   • DB_USER: your database username
   • DB_PASSWORD: your database password
   • DB_NAME: your database name
3. Configure the payment gateway settings in the payment_gateways.php file. This file contains a list of available payment gateways and their settings. You'll need to fill in the required information for your payment gateway (e.g., API keys, merchant IDs, etc.).
4. Create a new PHP file (e.g., index.php) and include the Recurring PayPage library using the following code:

   <?php
   require_once 'recuring-paypage/recuring_paypage.php';

   Step 1: Creating a Subscription Plan

To create a subscription plan, you'll need to add a new entry to the subscription_plans table in your database. You can do this by running the following SQL query:

INSERT INTO subscription_plans (name, description, amount, frequency, trial_days) 
VALUES ('Basic Plan', 'Our basic plan for $9.99/month', 9.99, 'monthly', 0);

This creates a new subscription plan called "Basic Plan" with a monthly fee of $9.99 and no trial period.

Step 2: Creating a Payment Gateway Instance

To create a payment gateway instance, you'll need to add a new entry to the payment_gateways table in your database. You can do this by running the following SQL query:

INSERT INTO payment_gateways (name, api_key, merchant_id, test_mode) 
VALUES ('PayPal', 'your_api_key_here', 'your_merchant_id_here', 1);

This creates a new payment gateway instance for PayPal with your API key and merchant ID. You'll need to replace your_api_key_here and your_merchant_id_here with your actual PayPal API key and merchant ID.

Step 3: Creating a Subscription

To create a subscription, you'll need to call the create_subscription function and pass in the following parameters:

• plan_id: the ID of the subscription plan you created earlier
• payment_gateway_id: the ID of the payment gateway instance you created earlier
• customer_email: the email address of the customer
• customer_name: the name of the customer
• customer_address: the address of the customer

Here's an example of how you might call the create_subscription function:

<?php
$plan_id = 1;
$payment_gateway_id = 1;
$customer_email = 'john.doe@example.com';
$customer_name = 'John Doe';
$customer_address = '123 Main St, Anytown, USA';

$result = recurring_paypage::create_subscription($plan_id, $payment_gateway_id, $customer_email, $customer_name, $customer_address);

if ($result) {
    echo 'Subscription created successfully!';
} else {
    echo 'Error creating subscription: '. $result->getMessage();
}

This code creates a new subscription for the "Basic Plan" with the PayPal payment gateway, using the customer's email address, name, and address.

Step 4: Handling Payment Notifications

To handle payment notifications, you'll need to set up a webhook to receive notifications from the payment gateway. You can do this by creating a new PHP file (e.g., webhook.php) and including the Recurring PayPage library:

<?php
require_once 'recuring-paypage/recuring_paypage.php';

// Set up the webhook to receive payment notifications
recurring_paypage::set_webhook('https://yourwebsite.com/webhook.php');

In this file, you'll need to write code to handle the payment notifications. For example, you might want to update the subscription status or send a confirmation email to the customer.

Conclusion

That's it! You've now set up Recurring PayPage and created a subscription plan, payment gateway instance, and subscription. You've also learned how to handle payment notifications using a webhook. With Recurring PayPage, you can easily manage recurring payments and subscriptions for your website.