Connect PayPal with Flexi Subscription #

Accept recurring subscription payments securely using PayPal. This guide walks you through connecting your PayPal account, configuring the required settings, and testing your integration before accepting live payments.

Before You Begin

Ensure that:

1. WooCommerce is installed and configured.
2. Flexi Subscription is activated.
3. PayPal Payments (or your preferred PayPal plugin) is installed.
4. You have access to a PayPal Business account.

Step 1: Install the PayPal Payment Plugin #

If you haven’t already installed a PayPal gateway:

1. Go to Plugins → Add New.
2. Search for WooCommerce PayPal Payments.
3. Click Install, then Activate.
4. Complete the initial setup wizard if prompted.

Step 2: Enable PayPal in WooCommerce #

1. Open WooCommerce → Settings → Payments.
2. Locate PayPal from the available gateways.
3. Click Manage.
4. Enable the payment method.
5. Save your settings.

Tip:You can customize the gateway title and description that customers will see during checkout.

Step 3: Connect Your PayPal Account #

1. Inside the PayPal settings page, click Connect to PayPal.
2. Log in using your PayPal Business Account.
3. Grant the required permissions.
4. Wait until WooCommerce confirms the successful connection.

Once connected, your merchant account will automatically sync with WooCommerce.

Step 4: Configure Payment Preferences #

Review and configure the following options according to your business needs:

1. Payment capture method
2. Sandbox or Live mode
3. Debug logging
4. Customer invoice details
5. Webhook synchronization
6. Currency compatibility

After making changes, click Save Changes.

Recommended:Use Sandbox Mode while testing subscriptions to avoid processing real payments.

Step 5: Test a Subscription Purchase #

Before launching your store:

1. Create a subscription product.
2. Visit your storefront.
3. Purchase the subscription using PayPal.
4. Verify that:
   • Checkout completes successfully.
   • The subscription is created.
   • The payment appears in WooCommerce.
   • Renewal scheduling is generated correctly.

Managing Subscription Renewals #

Once PayPal is connected, recurring payments are processed automatically whenever possible.

Customers can:

1. View active subscriptions
2. Update payment methods (when supported)
3. Cancel subscriptions
4. Renew expired subscriptions

Store administrators can monitor renewals from the Flexi Subscription dashboard.

Important:Automatic renewals require a compatible PayPal integration. Some payment methods may only support manual renewals depending on regional availability.

Troubleshooting #

PayPal doesn’t appear during checkout #

Check that:

1. PayPal is enabled.
2. The gateway supports your store currency.
3. SSL is enabled on your website.
4. The payment gateway plugin is active.

Subscription payment fails #

Verify:

1. The customer completed PayPal authorization.
2. API credentials are valid.
3. Webhooks are functioning correctly.
4. The PayPal account is fully verified.

Sandbox isn’t working #

Ensure:

1. Sandbox mode is enabled.
2. You’re using PayPal Sandbox accounts.
3. Test API credentials are configured correctly.

Best Practices #

1. Always test in Sandbox before switching to Live.
2. Keep your payment plugin updated.
3. Regularly review webhook status.
4. Monitor failed renewals from the subscription dashboard.
5. Test subscription renewals after major plugin updates.