Configure Cartridge

Key Configuration Settings

๐Ÿ“˜

Express Checkout is available in all supported countries

Once the cartridge has been installed you can configure the following settings from the Business Manager.

Business Manager

Afterpay configuration can be accessed in the Site Preferences > Custom Preferences section of the Business Manager.

480

The below fields should be configured for your region:

Site Preference Description Default Values
apDelayRetry The field is required to set delay time for the unavailable service.
CapturePayment The field is used to set timeout for the Direct Timeout Capture payments.
UserAgent The field is used to send the UserAgent details to Afterpay.
Enable Afterpay The field determines if the Afterpay is enabled / disabled in the cartridge. FALSE
Afterpay Display Product Details Page Information The field determines if the Afterpay messaging is displayed on the Product Details Page. TRUE
Afterpay Display Product List Page Information The field determines if the Afterpay messaging is displayed on the Product List Page. FALSE
Afterpay Learn More URL The URL that links to more information about Afterpay that users can click to view. ๐Ÿ‡ฆ๐Ÿ‡บ AU:
https://www.afterpay.com.au/terms/ ๐Ÿ‡บ๐Ÿ‡ธ US:
https://www.afterpay.com/purchase-payment-agreement
Afterpay Payment Mode This field determines if the payment should be Authorised only or if a Direct Capture is to be used. Merchant Specific โ€“ Select the ones to be supported.
Afterpay Service Name This field is used to identify the service with Afterpay. This only needs to be changed if you are using multiple sites where those sites are using additional Afterpay accounts as the accounts are stored in the service ๐Ÿ‡ฆ๐Ÿ‡บ AU:
afterpay.http.defaultendpoint
๐Ÿ‡ณ๐Ÿ‡ฟ NZ:
afterpay.http.defaultendpoint.NZ
๐Ÿ‡บ๐Ÿ‡ธ US:
afterpay.http.defaultendpoint.US
Afterpay JavaScript URL The endpoint where the javascript library is obtained from โ€“ Use
Sandbox - https://portal.sandbox.afterpay.com/afterpay.js
  
Production - https://portal.afterpay.com/afterpay.js
Default Controller Cartridge Name
*not used in SFRA
Name of default storefront controller cartridge app_storefront_controllers
Default Core Cartridge
*not used in SFRA
Name of default storefront core cartridge
Afterpay Minimum Threshold Amount Afterpay minimum threshold amount
Afterpay Maximum Threshold Amount Afterpay maximum threshold amount

๐Ÿšง

Upgrading to Express Checkout

Download the upgrade guide through Afterpay's Github repository.

SFCC Express Checkout Custom Site Preferences to be Added

Site PreferenceDescriptionDefault
Enable Express Checkout
apEnableExpressCheckout
Enables the Express Checkout featureYes
Express Checkout Javascript Snippet
apExpressCheckoutJS
URL for the Javascript snippet used to launch the Express Checkout popup windowhttps://portal.sandbox.afterpay.com/afterpay.js?merchant_key=demo
Enable BuyNow
apEnableExpressCheckoutBuyNow
Enables the BuyNow mode. Skips review page on merchant checkout. (Note: Only used for Integrated Shipping)Yes
Express Checkout Shipping Strategy
apExpressCheckoutShippingStrategy
Select either Integrated Shipping (Afterpay Checkout prompts for shipping method), or deferred (merchant site handles shipping method selection)Integrated
Description Express Checkout will use for In-Store Pickup
apStorePickupDescription
Prompt to use in Afterpay Express Checkout for in-store pickup ordersAvailable for next-day pickup
Enable Express Checkout on Product Details Page
apEnableExpressCheckoutPdp
enable Express Checkout directly from the product detail pageNo