To complete the Afterpay migration, update your cartridge. When you upgrade the Afterpay cartridge, you automatically receive the user experience benefits of Afterpay.
See the instructions below:
To use the Afterpay product with Salesforce, download the latest version of the Afterpay cartridge here.
See the Install the Cartridge and Import the Metadata section below to install the new cartridge and integrate it with your systems.
To install the lastest version of the cartridge, do the following:
Download the cartridge
Build the client-side Resources. These are the client-side CSS (Cascading Style Sheets) and JS (JavaScript) files that are specific to Afterpay; this is a required step.
package.json contains the correct reference to the location of the SFRA base cartridge (Only for SFRA):Set the path. Set the path to the base cartridge of SFCC which is required for the Afterpay cartridge to work.
Install/Run commands. These commands install the node in our cartridge onto your local storage and compiles the JS and CSS files residing in our cartridge.
Import the cartridge. Use UX Studio to import the cartridge. Alternatively, you can also use Node Package Manager (npm) and run uploadCartridge, or the VSCode Prophet plugin.
Once you have completed the five steps above, you are ready to import the metadata. See the section below.
For the Afterpay integration to work, the following object structures (metadata) must be imported and configured in the Business Manager. Do the following:
In the cartridge bundle go to the folder metadata/afterpay-meta-import/sites.
Rename the RefArch folder to the ID of your site. You can find the site ID in Administration > Sites > Manage Sites in the Business Manager.
Compress the afterpay-meta-import folder to generate the afterpay-meta-import.zip file.
In the Business Manager, go to Administration > Site Development > Site Import & Export and import the zipped file.
Once you have imported the metadata, you are ready to make some final checks. See the section below.
If you are using SiteGenesis, see the SiteGenesis code changes page to add Afterpay-specific code changes to your base store cartridges.
If you are using SFRA, see the SFRA Files change review page to see the files that override the files in the base cartridge.
There are new Afterpay brand assets to use at checkout and across your site. See the Brand Assets page in this guide for these new assets.
The table below has examples of the changes:
Messaging is automatically updated if you use On-Site Messaging, our current messaging product, or its predecessor that used the JavaScript library for messaging. In both cases wait for the automatic update process to occur. Monitor your email for advance notice of this automatic update.
See the table below for an example of the changes:
The automatic Messaging update includes changes to learn more/lightbox asset if you use that.
If you use elements of Afterpay Messaging but not the standard Onsite Messaging Widget, then update the Afterpay elements with the latest Afterpay elements. See the Brand Assets section above.
Any custom messaging updates must be reviewed by your Account Manager.
If you have a technical question on the migration, see our FAQs for the Migration page.
