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.
GuidesAPI Reference
GuidesAPI Reference
  • Welcome
    • Getting Started
    • Business Hub
    • Afterpay Migration
  • Platforms
    • Platforms Quickstart
    • Adobe Commerce (Magento)
    • Adyen
    • BigCommerce
    • Ecwid
    • PrestaShop
      • PrestaShop
      • Updating the Afterpay module
    • Salesforce Commerce Cloud
    • Shopify
    • Stripe
    • Wix
    • WooCommerce
  • Afterpay Messaging
    • Getting Started
    • Placement
    • Implementation
    • Migration
    • Older Messaging Information and Links
    • Launch Afterpay Info Modal Anywhere
  • API Development
    • API Quickstart
    • Test Environments
    • Certification
    • Disputes
    • Webhook Signature Generation
  • SDK
    • SDK Migration Guide
    • iOS SDK
    • Android SDK
    • React Native 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
Platforms

Getting Started

Was this page helpful?
Previous

PrestaShop

Next
Built with

Afterpay migration
If you are an Afterpay merchant, see the Migration page for information on the Afterpay migration.
Follow the instructions below.

Setting up Afterpay with PrestaShop

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

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.

From time to time the Afterpay module is updated. To ensure you have the most up-to-date module, follow the procedure(s) in the Updating the Afterpay Module page.

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 - for testing.
Production - For live order processing.
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.
Restricted CategoriesThis enables you to restrict Afterpay to 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 is linked to on the product page. Only change this value if the messaging doesn’t appear correctly.
Price CSS (Cascading Style Sheet) 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 (Document Object Model) 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. As Afterpay is only available in the USA, set the market region to USA and the base currency to US dollars.

Warning

Check that your store’s base currency is set to USD ($).

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 Cash App 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, 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