Skip to content

New service | Change log

Installation

How to get the Plugin

  1. Go to the Worldpay Payments Cartridge for B2C Commerce page on Salesforce AppExchange.

  2. Click "Get It Now" to be redirected to our public GitHub repository. Download the Worldpay Payments cartridge source code zip file.

  3. Make sure the "app_storefront_base" and Worldpay Payments cartridge folders appear under the same folder.

  4. Open jobs.xml in the source code zip file. The relative path will be similar to "salesforce-commerce-cloud-master/metadata/jobs.xml".

  5. Replace the context site-id value in jobs.xml with your storefront name, written without spaces (e.g. AccessImplementation). You can find this on your Business Manager home page.

Site ID screenshot

Need help installing? Click here for more guidance

  • Use node version 14 or higher.

  • Run npm install.

  • Run npm run compile:js and then npm run compile:scss.

  • Using the same folder you have saved all the cartridge folders in, create a dw.json file and add the following:

{

               "hostname" : "your-sandbox-hostname.demandware.net",

               "username" : "your username to log in to SFCC",

               "password" : "your password to log in to SFCC",

               "code-version" : "the code version to upload to",

}
  • Upload the code to your environments (for example, using the Prophet Debugger extension for VS Code).

How to configure the Plugin

  1. Log into the Salesforce Business Manager interface and go to Administration → Sites → Manage Sites. Click on "Business Manager", then include int_worldpay_access in the cartridge list.

    Make sure int_worldpay_access is in front of bm_app_storefront_base in the cartridge path of your site (e.g. int_worldpay_access:bm_app_storefront_base).

Business Manager cartridge path screenshot

  1. Include int_worldpay_access and int_worldpay_core in the cartridge list for your storefront by going to Administration → Sites → Manage Sites. Click on your storefront site and the "Settings" tab.

    Ensure int_worldpay_access and int_worldpay_core are in front of app_storefront_base in the cartridge path of your site (e.g. int_worldpay_access:int_worldpay_core:app_storefront_base).

Storefront cartridge path screenshot

  1. Go to Administration → Site Development → Site Import & Export and import the metadata folder as a zip file.

  2. Navigate to Merchant Tools → Site Preferences → Custom Preferences and click on "AWP-Core" in the "ID" column.

    Enter the merchant entity that your Implementation Manager has given you. The merchant entity used for transactions is the same for Try and Live.

Supported payment methods

The Plugin enables payments via our Hosted Payment Pages API and supports:

  • Visa
  • Mastercard
  • Amex
  • Google Pay
  • Apple Pay

Confirm the Plugin settings

A successful import of the metadata makes the below custom preferences available:

Custom preferences screenshot

  • Verify that you have imported "Worldpay" as a Payment Processor by going to Merchant Tools → Ordering → Payment Processors.

Payment Processors page screenshot Apply button to confirm payment processor

  • Verify that you have imported "Worldpay" as an available payment method by going to Merchant Tools → Ordering → Payment Methods.

Payment Methods page screenshot

Enable 3DS authentication

You can enable 3DS authentication functionality to verify your customer's identity and meet the Strong Customer Authentication (SCA) requirements under the PSD2 regulation. Learn more about when SCA applies.

  • Go to Merchant Tools → Site Preferences → Custom Preferences and click on "AWP-Core".

  • Select "Yes" for the "Enable ThreeDs" field.

Enable ThreeDs field screenshot

Next steps

Optional configuration for your Plugin
Testing and Go live