Magento Plugin Integration Guide

Integrating, Configuring and Testing

The BlueTape Pay plugin is a configurable extension that can be added to your Magento or Magento CMS e-commerce site. Once integrated to your site, customers will be shown BlueTape payment options right within your checkout page, offering seamless Cards, ACH bank transfer, and BlueTape Trade Credit. 

Before getting started, here are the prerequisites to install the BlueTape Pay plugin with Magento:

1. Make sure Magento is updated to the latest version (2.4) and have a site ready with a demo/sandbox environment for testing purposes. Ideally the demo or sandbox testing site will be as similar as possible as your live site.
2. Ensure that you have access to the Magento Admin Panel.
3. Have a registered and approved BlueTape account. If one has yet to be made, you can create one on our BlueTape Sign Up page.
4. Obtain the necessary API keys for your BlueTape account. These will be provided to you upon request from BlueTape.

Part 1: Installation

1. Log in to the Magento Admin Panel. This can be accessed by logging in here.
   
   
2. In the left-hand menu, navigate to Extensions > Marketplace.
3. Click on Extension Manager or Marketplace. In the search bar, search for “BlueTape Pay.”
   
4. Click Add to Cart and proceed through checkout. While the extension is free of charge, you will still need to add it to your cart and check out.
   
   
   
   
5. Once purchased or added to your account, go back to Extension Manager in your Magento Admin Panel.
6. Click Review and Install, find BlueTape Pay, and click Install. Follow the on-screen instructions and click Next to proceed with the installation.
7. Once the installation is complete, click Finish and clear the Magento cache by navigating to System > Cache Management and clicking Flush Magento Cache.
8. After installing the module, run the following commands to complete the installation:

php bin/magento setup:upgrade

php bin/magento setup:di:compile

php bin/magento setup:static-content:deploy

php bin/magento cache:flush

Part 2: Configuring BlueTape API Keys

1. Get Your API Keys: Log into your BlueTape account, navigate to your account settings, and copy both your Test and Live API keys. 
2. Enter API Keys in Adobe Commerce. In the CMS Magento admin panel, navigate to Stores > Configuration > Sales > Payment Methods. Find BlueTape Payments and enter your Test and Live API keys.
   
   
   
3. Save the configuration.
4. Enable Test Mode for testing payments before going live.
   

Part 3: Configuring Payment Options

1. Enable Payment Methods: Choose which payment methods (credit cards, bank transfers, etc.) you want to enable in the BlueTape extension configuration.
2. Set Up Payment Page Redirection: Configure whether customers are redirected to the BlueTape payment page for secure transaction processing.

Further Testing:

You can find a demo of the customer experience below.

You are welcome to replicate these steps in your own demo account. Add items to your cart, view cart, and check out. You can sign up as a new customer or check out as a guest and follow the prompts until payment is finalized. In your production account, you can do the same, but be mindful of using real funds for those test transactions.