Paddle Gateway by Blesta.Club - Installation Guide

Welcome, and thank you for purchasing the Paddle Gateway! We're delighted to have you as a customer and are committed to ensuring you have a seamless experience. This README aims to guide you through the installation of your new gateway. If you're new to Blesta or encounter any issues, please don't hesitate to reach out for support.

Installation Guide

For detailed instructions on how to install the Paddle Gateway, please ensure you have the license manager installed for leased extensions and follow these steps:

1. Obtain the Gateway:

   • Download the Paddle Gateway from the download section of my.blesta.club.

2. Upload to Blesta:

   • Upload the Paddle Gateway to your Blesta gateways directory:

     /var/www/html/blesta/components/gateways/nonmerchant/paddle/

3. Install the Gateway:

   • Log in to your Blesta admin account.
   • Navigate to Settings > Payment Gateways.
   • Find the Paddle Gateway under the "Available" tab and click the "Install" button.

Setting Up the Gateway

1. Configure the Gateway:

   • Navigate to Settings > Payment Gateways (/admin/settings/company/gateways/installed/).
   • Find the "Paddle" Gateway and click on "Manage".
   • Input your Paddle API credentials (Vendor ID and Authentication Key) and configure additional settings as needed.

2. Enable Payment Processing:

   • After configuring, ensure the gateway is enabled for payment processing in your Blesta system.

You're now done with the installation! Proceed to configure the gateway as needed by following the usage guide.

Contact Us

If you encounter any issues or have suggestions for improving the gateway, please get in touch with us. We are committed to providing robust updates and welcome customer feedback.

Paddle Gateway by Blesta.Club - Update Guide

To ensure you are using the latest version of the Paddle Gateway, follow these steps to update the gateway in your Blesta installation.

Steps for Updating the Gateway

1. Download the Latest Version

• Visit the download section of my.blesta.club to obtain the latest version of the Paddle Gateway.

2. Upload the Updated Gateway

• Upload the updated files to your Blesta installation directory, replacing the existing files:

   /var/www/html/blesta/components/gateways/nonmerchant/paddle/

3. Update the Gateway in Blesta

• Log in to your Blesta admin account.
• Navigate to Settings > Payment Gateways.
• Locate the Paddle Gateway in the list and click the "Upgrade" or "Update" button if available.

4. Clear Cache

• Once the files are uploaded and the gateway is updated, clear the Blesta cache by navigating to Settings > System and selecting "Clear Cache."

5. Check Configuration

• After the update, review your Paddle API credentials (Vendor ID and Authentication Key) to ensure they are correctly configured. Navigate to Settings > Payment Gateways and manage the Paddle Gateway to verify the settings.

Testing the Update

1. Test Mode:

   • Before switching to live transactions, use Paddle’s sandbox mode to ensure that the update is functioning as expected.

2. Transaction Testing:

   • Perform a test transaction using the updated gateway to verify that payments are being processed successfully.

Troubleshooting Update Issues

1. Missing or Incorrect Files:

   • If you experience issues, ensure all files have been uploaded correctly and verify file permissions.

2. API Key Issues:

   • If transactions are failing, check that the correct API credentials are configured in the gateway settings.

3. Compatibility Issues:

   • Confirm that the updated version of the gateway is compatible with your current Blesta version. Check the changelog for any version-related notes.

Contact Us

If you encounter any issues during the update process or have suggestions for improving the gateway, please reach out to us. We are dedicated to providing robust updates and value customer feedback.

Paddle Gateway by Blesta.Club - Usage Guide

Welcome, and thank you for purchasing the Paddle Gateway! This guide aims to walk you through how to use the Paddle Gateway effectively within Blesta. If you're new to Blesta or encounter any issues, please don't hesitate to reach out for support.

Using the Gateway

Once installed and configured, the Paddle Gateway will allow your clients to use the supported payment methods seamlessly.

Client View

• Clients will see Paddle as a payment method at checkout and invoice payments.
• They will be redirected to Paddle's secure platform to complete the transaction.

Admin View

1. Configuring Payment Settings:

   • Navigate to Settings > Payment Gateways in the Blesta admin panel (/admin/settings/company/gateways/installed/).
   • Customize the payment options, currency settings, and other configurations to match your needs.

2. Enable Paddle for Invoices:

   • Ensure the Paddle Gateway is enabled and accessible on all relevant invoice templates and order forms.

Testing the Gateway

1. Test Mode:

   • Use Paddle’s sandbox environment to test transactions before going live, allowing you to verify the setup and functionality.

2. Switch to Live Mode:

   • Once testing is complete, switch to live mode to enable real transactions.

Troubleshooting Common Issues

1. Transaction Failures:
   • Ensure that the Paddle API credentials (Vendor ID, Authentication Key) are correctly configured in Blesta.
2. Currency Mismatch:
   • Ensure that the currency settings in Blesta match those supported by Paddle to avoid errors.

Contact Us

If you encounter any issues or have suggestions for improving the gateway, please get in touch with us. We are committed to providing robust updates and welcome customer feedback.