This section outlines the steps to install the Afterpay plugin on your Magento instance for the first time.
Magento can be installed in any folder on the merchant’s server however for the purposes of this document, [MAGENTO] will refer to the root folder where Magento is installed.
- The Magento-Afterpay plugin is available as a .zip or tar.gz file from the Afterpay GitHub directory.
- Unzip the file and follow the following instructions to copy the files to the Magento website directory.
- Copy all files in:
/app/code/community/
to:
[MAGENTO]/app/code/community - Copy all files in:
/app/design/frontend/base/default/layout
to:
[MAGENTO]/app/design/frontend/base/default/layout - Copy all files in:
/app/design/frontend/base/default/template
to:
[MAGENTO]/app/design/frontend/base/default/template - Copy all files in:
/app/design/adminhtml/default/default/template
to:
[MAGENTO] /app/design/adminhtml/default/default/template - Copy all files in:
/app/etc
to:
[MAGENTO]/app/etc - Copy all files in:
/js
to:
[MAGENTO]/js - Copy all files in:
/skin/frontend/base/default
to:
[MAGENTO]/skin/frontend/base/default - Login to Magento Admin and navigate to System/Cache Management
- Flush the cache storage by selecting Flush Cache Storage
Afterpay operates under a list of assumptions based on Magento configurations. To align with these assumptions, the Magento configurations must reflect the below.
-
Website Currency must be set to AUD
Navigate to Magento Admin/System/Configuration/Currency Setup Set the base, display and allowed currency to AUD. -
Postcode must be mandatory
Navigate to Magento Admin/System/Configuration/General Deselect. Australia from Postal Code is Optional for the following countries. -
State must be mandatory
Navigate to Magento Admin/System/Configuration/General. Set Australia as one of the State is required for values.
To configure the merchant’s Afterpay Merchant Credentials in Magento Admin complete the below steps. Prerequisite for this section is to obtain an Afterpay Merchant ID and Secret Key from Afterpay.
- Navigate to Magento Admin/System/Configuration/Sales/Payment Methods/Afterpay
- Enter the Merchant ID and Merchant Key (provided by Afterpay)
- Enable Afterpay plugin using the Enabled checkbox.
- Configure the Afterpay API Mode (Sandbox Mode for testing on a staging instance and Production Mode for a live website and legitimate transactions).
- Save the configuration.
- Click the Update Payment Limits button to retrieve the Minimum and Maximum Afterpay Order values.
- Navigate to System/Configuration/Sales/Afterpay
- Enable Debug Mode to log transactions and ensure additional valuable data
- Configure the display of the Afterpay instalments details on Product Pages (individual product display pages) and Category Pages (the listing of products, which would also include Search Pages).
- Login to Magento Admin and navigate to System/Cache Management.
- Flush the cache storage by selecting Flush Cache Storage
This section outlines the steps to upgrade the currently installed Magento-Afterpay plugin version.
The process of upgrading the Magento-Afterpay plugin involves the complete removal of Magento-Afterpay plugin files, followed by copying the new files.
[MAGENTO] will refer to the root folder where you have installed your version of Magento.
- The Magento-Afterpay plugin is available as a .zip or tar.gz file from the Afterpay GitHub directory.
- Unzip the file and follow the following instructions to copy the files to the Magento website directory.
- Remove all files in:
[MAGENTO]/app/code/community/Afterpay - Copy new files to:
[MAGENTO]/app/code/community/Afterpay - Remove all files in:
[MAGENTO]/app/design/frontend/base/default/layout/afterpay.xml - Copy new files to:
[MAGENTO]/design/frontend/base/default/layout/afterpay.xml - Remove all files in:
[MAGENTO]/app/design/frontend/base/default/template/afterpay - Copy new files to:
[MAGENTO]/app/design/frontend/base/default/template/afterpay - Remove all files in:
[MAGENTO]/design/adminhtml/default/default/template/Afterpay - Copy new files to:
em>[MAGENTO]/design/adminhtml/default/default/template/Afterpay - Remove all files in:
[MAGENTO]/app/etc/modules/Afterpay_Afterpay.xml - Copy new files to:
[MAGENTO]/app/etc/modules/Afterpay_Afterpay.xml - Remove all files in:
[MAGENTO]/js/Afterpay - Copy new files to:
[MAGENTO]/js/Afterpay - Remove all files in:
[MAGENTO]/skin/frontend/base/default/afterpay - Copy new files to:
[MAGENTO]/skin/frontend/base/default/afterpay - Login to Magento Admin and navigate to System/Cache Management
- Flush the cache storage by selecting Flush Cache Storage