For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
HomeGuidesAPI Reference
HomeGuidesAPI Reference
  • Welcome
    • Business Hub
  • Platforms
    • Platforms Quickstart
    • Adyen
    • Ecwid
      • Introduction
      • Migrating to the new Afterpay module
    • Shopify
    • Stripe
  • Afterpay Messaging
    • Getting Started
    • Implementation
    • Migration
    • Legacy Messaging Products
    • Launch Afterpay Info Modal Anywhere
  • API Development
    • API Quickstart
    • Test Environments
    • Certification
    • Disputes
    • Upgrade from API v1 to v2
  • SDK
    • iOS SDK
    • Android SDK
    • React Native SDK
    • PHP SDK
  • Marketing
    • Shop Directory
    • Brand Assets
LogoLogo
On this page
  • Setting up Afterpay with PrestaShop
  • Install the Module
  • Store currency and language
  • Testing your configuration
  • Troubleshooting
  • Supported Countries
PlatformsPrestaShop

PrestaShop

Was this page helpful?
Previous

Migrating to the new Afterpay module

Next
Built with

Setting up Afterpay with PrestaShop

Afterpay has a module that you can install in the back office admin area for PrestaShop.

Note

Before you begin you must:

  • Have an Afterpay merchant account to use the Afterpay module with PrestaShop. Click here to sign up for an Afterpay merchant account.

  • Ensure that the Afterpay module for PrestaShop is compatible with PrestaShop versions 8, 1.7.x. and 1.6.x

Install the Module

To install the module do the following:

  1. In the Modules section of the PrestaShop admin area, select Module Catalog.

  2. Enter Afterpay in the module search box.

  3. Select Install.

  4. Select Configure. The Afterpay configuration panel appears.

  5. Enter your merchant ID and secret key and your API region and environment.

  6. Click Save in the lower-right corner.

SettingValue
Module is enabledYes - Afterpay turned on
No - Afterpay disabled.
Merchant IDYour 9 digit Afterpay Merchant ID.
Secret KeyYour 128 character Afterpay secret key.
API EnvironmentSandbox
Production
Min Payment Limit/Max Payment LimitCurrent minimum and maximum Afterpay order thresholds. These values are for information purposes and cannot be customized in Prestashop.
Enable MulticurrencyEnable multicurrency support.
CBT CountriesCross Border Trade (CBT) allows you to sell internationally. Customers in foreign countries pay in their local currencies, while Afterpay continues to settle with you in your local currency. This information is supplied by Afterpay and cannot be edited. This value is for information purposes and cannot be customized in Prestashop.
Payment LimitsCBT payment limits. This value is for information purposes and cannot be customized in Prestashop.
Restricted CategoriesThis enables the merchant to restrict Afterpay to the selected product categories.
Payment Info on Individual Product PageEnable to display Afterpay elements on individual product pages.
Product Page HOOKThis property sets the HOOK where Afterpay messaging are linked on the product page. Only change this value if it doesn’t appear correctly.
Price CSS SelectorThis property sets the CSS selector needed to show the assets on the product page. Only change this value if it doesn’t appear correctly.
Product Page CSS Position SelectorAfterpay messaging is moved after the CSS Selector DOM Element. Only change this value if it doesn’t appear correctly.
Payment Info on Cart PageEnable to display Afterpay elements on the cart page (available for PS 1.7 and higer).
Cart Page CSS SelectorThis property set the CSS selector needed to show the assets on the cart page. Only change this value if it doesn’t appear correctly.
Canonical URLsOnly Enable this option if the checkout doesn’t redirect correctly to the payment gateway and shows a 404 error.
Debug modeEnable the debug logging. You can see these logs in the Configure > Advanced Parameters > Logs section.
Enable ReversalIf Prestashop throws an exception while attempting to finalise an order after payment is approved by Afterpay, the payment can be reversed automatically. This may help to prevent scenarios where customers pay for orders that can’t be fulfilled. Not recommended if an external Order Management System (OMS) is in use.

Store currency and language

The module relies on a dedicated Website Scope being used for each market region (country) with a corresponding base currency and languages set in the PrestaShop admin area.

Check that the store’s base currency is set to one of the following: AUD, NZD, or CAD ($).

To set the Base Currency:

  1. Go to International.

  2. Select the Localization page and use the Default currency option from the Configuration section.

For more information see this section of the PrestaShop 1.7 & PrestaShop 1.6 documentation.

Testing your configuration

  1. Go to a product page to check whether Afterpay appears as a payment option. If the Afterpay widget does not appear, check that you have entered your Afterpay credentials correctly when you set up the Afterpay module.

  2. If Afterpay appears correctly as a payment option, go to the checkout page to test that the Afterpay information displays correctly.

Troubleshooting

If Afterpay does not update/display as expected, please provide staff access to your PrestaShop admin panel for our Integration Support Team.

Send an email to merchantadminus@afterpay.com and include the:

  • Admin panel URL

  • Admin panel user

  • Admin panel password

Supported Countries

Afterpay is available for PrestaShop merchants with a store in these countries:

  • Australia

  • Canada

  • New Zealand

Afterpay is known as Clearpay in the UK:

  • United Kingdom

Afterpay is known as Cash App Afterpay in the United States:

  • United States