Stripe Universal Gateway by Blesta.Club - Installation Guide

Welcome, and thank you for purchasing the Stripe Universal 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 Stripe Universal Gateway, please ensure you have the license manager installed for leased extensions and then follow these steps:

1. Obtain the Gateway:

   • Download the Stripe Universal Gateway from the download section of the client area.

2. Upload to Blesta:

   • Upload the Stripe Universal Gateway to your Blesta gateways directory:

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

3. Install the Gateway:

   • Log in to your Blesta admin account.
   • Navigate to Settings > Payment Gateways.
   • Find the Stripe Universal 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 "Stripe Universal" Gateway and click on "Manage".
   • Input your Stripe API keys and other necessary settings. Refer to the usage instructions if needed.

2. Enable Payment Processing:

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

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.

Stripe Universal Gateway by Blesta.Club - Update Guide

To ensure you are always using the latest version of the Stripe Universal Gateway, follow these steps to update the gateway within your Blesta installation.

Steps for Updating the Gateway

1. Download the Latest Version

• Visit the download section of the client area to obtain the latest version of the Stripe Universal Gateway.

2. Upload the Updated Gateway

• Upload the updated files to your Blesta installation directory, replacing the existing files.
• The directory path is:

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

3. Update the Gateway in Blesta

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

Testing the Update

1. Test Mode:

   • Before switching back to live transactions, you may want to test the gateway in Stripe's test mode to ensure everything works as expected.

2. Transaction Testing:

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

Troubleshooting Update Issues

1. Missing or Incorrect Files:

• If you experience issues after updating, ensure all files have been uploaded correctly to the appropriate directory.
• Check file permissions to ensure the web server can access the updated files.

2. API Key Issues:

• If transactions are failing after the update, verify that the correct API keys are configured in the gateway settings. Ensure that you're using live API keys for real transactions and test keys for testing purposes.

3. Version Compatibility:

• Make sure the updated version of the gateway is compatible with your current version of Blesta. Refer to the changelog or update notes for any breaking changes or version requirements.

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 consistent updates and value your feedback.

Stripe Universal Gateway by Blesta.Club - Usage Guide

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

Gateway Capabilities

The Stripe Universal Gateway is designed to process payments within Blesta, offering a seamless integration with your billing system. With support for a variety of payment options through Stripe, it provides flexibility and convenience for both you and your clients.

Things to Note

2. Currency Support: Stripe supports multiple currencies; configure your currency settings in Blesta accordingly to avoid processing errors.

Using the Gateway

Once the Stripe Universal Gateway is installed and configured, it will allow you to process payments for your Blesta billing system. Below are the general steps for managing the gateway:

Configure Payment Settings

1. Manage the Gateway:

   • Navigate to Settings > Payment Gateways in your Blesta admin panel (/admin/settings/company/gateways/installed/).
   • Select "Stripe Universal" Gateway and click on "Manage".
   • Enter your Stripe API keys (Publishable Key and Secret Key) and configure the necessary payment options like accepted currencies and card types. Click "Update Settings" to save your changes.

2. Enable Payment Processing:

   • Ensure that the Stripe Universal Gateway is enabled for processing payments in your Blesta system.
   • You can enable one-time payments, recurring payments, or both based on your billing model.

Testing the Gateway

Before going live, it is recommended to run a test transaction using Stripe’s test mode to ensure everything is working as expected. This allows you to verify that the integration is correct without making real charges.

1. Enable Test Mode:

   • In Stripe, switch to test mode and generate test API keys.
   • Use these test keys in the Blesta gateway settings and perform a test transaction to verify functionality.

2. Switch to Live Mode:

   • Once testing is complete, replace the test API keys with live API keys in Blesta to start processing real payments.

Troubleshooting Common Issues

Transaction Failures

• Verify API Keys: Ensure the API keys entered in the Blesta gateway settings are correct.
• Check Stripe Mode: Ensure that your Stripe account is not in test mode when trying to process live transactions.

Currency Mismatch

• Currency Configuration: Make sure the currency set in Blesta matches the currency settings in your Stripe account to avoid processing errors.

Quick Support

If you need help with setting up or managing the gateway, here’s how to obtain your Stripe API keys:

1. Login to Stripe:

   • Visit the Stripe Dashboard and log in with your credentials.

2. API Keys:

   • Navigate to Developers > API Keys.
   • Copy the "Publishable Key" and "Secret Key" from the dashboard.

3. Configure in Blesta:

   • Paste these keys into the corresponding fields in your Blesta gateway settings and save your changes.

Contact Us

If you encounter any issues or have suggestions for improving the gateway, please don't hesitate to contact us. We are committed to providing robust updates and appreciate customer feedback.