Stripe Payment intents Gateway by Blesta.Club - Installation Guide

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

1. Obtain the Gateway:

   • Download the Stripe Payment intents Gateway and the Stripe Payment intents Manager Plugin from the download section of the client area.

2. Upload to Blesta:

   • Upload the Stripe Payment intents Gateway to your Blesta gateways directory:

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

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 > Plugins (/admin/settings/company/plugins/installed/).
   • Find the "Stripe Payment intents" Plugin and click on "Manage".
   • Input your Stripe API keys and other necessary settings. Refer to the usage instructions if needed.

2. Ensure the Stripe Payment intents Manager plugin is also installed:

   • This is available from the client area, Follow the guide included to install that before moving onto 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 Payment Intents Gateway by Blesta.Club - Update Guide

To ensure you are always using the latest version of the Stripe Payment Intents 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 Payment Intents 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_payment_ntents/

3. Update the Gateway in Blesta

• Log in to your Blesta admin account.
• Navigate to Settings > Payment Gateways.
• Locate the Stripe Payment Intents 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.

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 Payment Intents Gateway by Blesta.Club - Usage Guide

Welcome, and thank you for choosing the Stripe Payment Intents 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.

Things to Note

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

2. Make sure additional methods are enabled from https://dashboard.stripe.com/settings/payments before usage! Obviously they override the configuration in Blesta

3. sk or rk? Used interchangably - Don't panic if they're worded slightly different until sk is phased out by Stripe

Using the Gateway

Once the Stripe Payment Intents 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 Payment Intents" Gateway and click on "Manage".
   • Configure the accepted currencies. Click "Update Settings" to save your changes.
   • Finally follow the guide.md to install Stripe Payment Intents Manager plugin! Then enable the gateway on order forms!

2. Enable Payment Processing:

   • Ensure that the Stripe Payment Intents Gateway is enabled for processing payments in your Blesta system by checking your order forms.

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.

Cannot declare class error

• Delete the vendor directory from the Stripe Gateway and Stripe Payments Blesta Gateways! These can be found at components/gateways/merchant/stripe_gateway and components/gateways/merchant/stripe_payments.
• If you downloaded Stripe Universal a while ago or have and older version, delete (if present) the vendor directory from it. It can be found installed at components/gateways/nonmerchant/stripe_universal.

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 and pick your payment methods from https://dashboard.stripe.com/settings/payment_methods/

2. API Keys:

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

3. Configure in Blesta:

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

If you notice that some payment methods are missing:

1. Login to Stripe:

   • Visit the Stripe Dashboard and log in with your credentials and pick your payment methods from https://dashboard.stripe.com/settings/payment_methods/

2. Click on your payment method:

   • Check the following:
     • Does the method support "Recurring payments"? If not, it is not supported by Stripe Payment Intents. Use Stripe Universal instead.
     • Are you using the "Supported currencies" of the payment method? If not, change the currency used.

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.