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.

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 Preference | Description | Default |
---|---|---|
Enable Express CheckoutapEnableExpressCheckout | Enables the Express Checkout feature | Yes |
Express Checkout Javascript SnippetapExpressCheckoutJS | URL for the Javascript snippet used to launch the Express Checkout popup window | https://portal.sandbox.afterpay.com/afterpay.js?merchant_key=demo |
Enable BuyNowapEnableExpressCheckoutBuyNow | Enables the BuyNow mode. Skips review page on merchant checkout. (Note: Only used for Integrated Shipping) | Yes |
Express Checkout Shipping StrategyapExpressCheckoutShippingStrategy | 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 PickupapStorePickupDescription | Prompt to use in Afterpay Express Checkout for in-store pickup orders | Available for next-day pickup |
Enable Express Checkout on Product Details PageapEnableExpressCheckoutPdp | enable Express Checkout directly from the product detail page | No |
Updated 3 months ago