How To: Square Payment Installation Instructions

Magento version 2.x

Back to the Square Payments Extension Overview

Purpose

The purpose of this document is to provide you with detailed instructions for installing your Square Payments extension to connect your Magento e-commerce website with your existing Square Account.

Requirements

Square requires a SSL certificate for transactions. Proper installation requires the SSL to be in place
Magento cron must be enabled and running
- Cron configuration guide – Magento 1
- Cron configuration guide – Magento 2
The extension is only certified with Standard Magento Checkout, and IWD Agency Free one-page checkouts

Installation

Download OPG Square installation package.
Upload contents of the OPG Square installation package to your store root directory.
- Create folder /app/code/OPG/Square
- Upload content of the OPG Square installation package to /app/code/OPG/Square
Connect to the server through SSH (you can use putty).
Navigate to the “public_html” directory. (The command to do this is: cd public_html < enter >)
Execute the following command: composer require square/connect
Execute the following command: php -f bin/magento setup:upgrade < enter >
Once complete, execute the following command: php -f bin/magento setup:static-content:deploy < enter >
NOTE: The above command will take some time to complete the process.
Once the above process is complete, you will need to clean the cache. This can be done by executing the following command: php bin/magento cache:clean < enter >
Now you will need to flush the cache. This can be done by executing the following command: php bin/magento cache:flush < enter >
Log in the Magento Admin Panel.
In the far left navigation menu, select “Stores”.
From the Stores menu, select “Configuration”.
Once the Configuration page loads, from the left Configuration navigation menu, select “Sales”.
From the dropdown list of the Sales options, select “Payment Methods”.
At the bottom of the Payment Methods page, select “Square”.
Once the “Square” option is open, set the following:
- Enabled = Yes
- Select the “Obtain and access token” button
- Enter the login credentials for the Square Account and select “Sign In”
  - This will access the Square Account to obtain and auto-fill the Personal Access Token information
- Title = Credit Card (Square), or whatever you wish.
- Select a sandbox location
- Sandbox = “No”.
NOTE: Should the following message display, “One or more of the Cache Types are invalidated:Configuration, Page Cache. Please go to Cache Management and refresh cache types.”, do the following otherwise, proceed to the next step (24).
- Click the “Cache Management” link and select “Flush Magento Cache”.
- Once the process is complete return to the Payment Methods section (From the left navigation menu select Stores> Configuration>Sales> Payment Method> Square).
Select “Save Config” in the top right corner.
NOTE: Should the following message display, “One or more of the Cache Types are invalidated:Configuration, Page Cache. Please go to Cache Management and refresh cache types.”, repeat step 23.
After an order is place from the front end using Square as the payment method, Magento Admin Panel will display the following on the Order Details:
- Under Payment Information, “Credit Card (Square)” will be displayed.
- At the very bottom or the Order Details, “Captured amount of $XX.XX online. Transaction ID: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx’’ will be displayed.