DITIntl / afterpay-prestashop-1.6

Afterpay PrestaShop 1.6 Module

1.1 Website Configuration

Afterpay operates under a list of assumptions based on PrestaShop Back Office configurations. To align with these assumptions, the PrestaShop Back Office configurations must reflect the below:

1. Website Currency must be set to 'AUD'
   1. PrestaShop Back Office > Localization > Currencies
2. Website Country must be set to ‘AU’
   1. PrestaShop Back Office > Localization > Countries
3. 'Zip/Costal Code' must be set to 'Yes'
   1. PrestaShop Back Office > Localization > Countries > Australia
4. 'Contains States' must be set to 'Yes'
   1. PrestaShop Back Office > Localization > Countries > Australia
5. 'Address' required fields must include the below values:
   1. Firstname, lastname, email, address1, postcode, city, phone
   2. PrestaShop Back Office > Localization > Countries > Australia

1.2 New Afterpay Module Installation

This section outlines the steps to install the Afterpay module on a PrestaShop website for the first time.

1. Download the Afterpay Module (https://github.com/afterpay/afterpay-prestashop-1.6/raw/master/afterpay.zip).
2. Navigate to: PrestaShop Back Office > Modules > Modules & Services.
3. Click Add a new module
4. Click Choose a file
5. Select the Afterpay module ZIP file.
6. Click Upload this Module
7. Under the Modules List section, locate the Afterpay Payment Gateway module and click install
8. Upon a successful installation, the Afterpay Payment Gateway configuration screen will be displayed with a notification stating: Module(s) installed successfully.

1.3 Afterpay Merchant Setup

To configure PrestaShop to utilise the Afterpay Payment Gateway, the below steps must be completed.

Prerequisite for this section is to obtain an Afterpay Merchant ID and Merchant Key from Afterpay.

1. Upon completion of the installation, you will be redirected to the Afterpay module configuration screen, alternatively:
   • Navigate to: PrestaShop Back Office > Modules > Modules & Services.
   • Locate the Afterpay Payment Gateway module and click 'Configure'.
2. Enable the Afterpay module by setting 'Enabled' to 'Yes'.
3. Enter 'Merchant ID'.
4. Enter 'Merchant Key'.
5. Select applicable 'API Environment'.
   • 'Sandbox' API Environment for performing test transactions on a staging website.
   • 'Production' API Environment for live transactions on the production website.
6. Click 'Save'.
7. Upon a successful configuration save, the Min and Max Payment Limit values will be updated with a notification stating: Settings Updated.

1.4 Upgrade of Afterpay Module

This section outlines the steps to upgrade the currently installed Afterpay module. The process involves the complete removal of the currently installed module, followed by the installation of the new module.

1. Navigate to: PrestaShop Back Office > Modules > Modules & Services.
2. Locate the Afterpay Payment Gateway module.
3. Click the dropdown and select 'Uninstall'.
4. Click the dropdown and select 'Delete'.
5. Download the Afterpay Module (https://github.com/afterpay/afterpay-prestashop-1.6/raw/master/afterpay.zip).
6. Navigate to: PrestaShop Back Office > Modules > Modules & Services.
7. Click Add a new module
8. Click Choose a file
9. Select the Afterpay module ZIP file.
10. Click Upload this Module
11. Under the Modules List section, locate the Afterpay Payment Gateway module and click install
12. Upon a successful installation, the Afterpay Payment Gateway configuration screen will be displayed with a notification stating: Module(s) installed successfully.
13. Enable the Afterpay module by setting 'Enabled' to 'Yes'.
14. Enter 'Merchant ID'.
15. Enter 'Merchant Key'.
16. Select applicable 'API Environment'.
    • 'Sandbox' API Environment for performing test transactions on a staging website.
    • 'Production' API Environment for live transactions on the production website.
17. Click 'Save'.
18. Upon a successful configuration save, the Min and Max Payment Limit values will be updated with a notification stating: Settings Updated.