Platforms

Getting Started

Migrate from Afterpay to Cash App Afterpay
If you are an Afterpay merchant, see the Migration page for information on the migration from Afterpay to Cash App Afterpay.
Follow the instructions below.

Setting up Cash App Afterpay with PrestaShop

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

Before you begin you must:

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

  • Ensure that the Cash App 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 Cash App Afterpay module is updated. To ensure you have the most up-to-date module, follow the procedure(s) in the Updating the Cash App Afterpay Module page.

SettingValue
Module is enabledYes - Cash App Afterpay turned on
No - Cash App Afterpay disabled.
Merchant IDYour 9 digit Cash App Afterpay Merchant ID.
Secret KeyYour 128 character Cash App Afterpay secret key.
API EnvironmentSandbox - for testing.
Production - For live order processing.
Min Payment Limit/Max Payment LimitCurrent minimum and maximum Cash App 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 Cash App Afterpay to selected product categories.
Payment Info on Individual Product PageEnable to display Cash App Afterpay elements on individual product pages.
Product Page HOOKThis property sets the HOOK where Cash App 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 SelectorCash App Afterpay 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 Cash App 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 Cash App 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 Cash App 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 Cash App Afterpay appears as a payment option. If the Cash App 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 Cash App Afterpay appears correctly as a payment option, go to the checkout page to test that the Cash App Afterpay information displays correctly.

Troubleshooting

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