New service | [**Change log**](/products/plugins/change-log)

# Installation

## How to get the Plugin

1. Go to the [Worldpay Payments Cartridge for B2C Commerce](https://appexchange.salesforce.com/appxListingDetail?listingId=b84e930e-9eb7-49b6-9868-cfc251a0a7b7) 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](/assets/storefront-name.dc3be390158f68083ea10002dc8d5aba8c88f774cf06f944dfe4a2bae5b65e14.39c0f7df.png)

details
summary
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](/assets/manage-payments-3.578ca444d16128e5e75dfb91102d74789e166d21716e8b39b588265063cb3864.39c0f7df.png)

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](/assets/cartridge-path-storefront.5286fc947e5fe768a517b0dee26ac88657ffb5346d0d8487deae12837493de3a.39c0f7df.png)

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](/assets/custom-preferences.5f39b91c20979a587bd4d6c96295128664be565d5615637f5262e83f8c3e2a89.39c0f7df.png)

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


![Payment Processors page screenshot](/assets/payment-processors.3fa9e3dbeb6ec4f2046a3c69d6ecc23ae926881d9c063c758037b3b5cb0bb91d.39c0f7df.png)
![Apply button to confirm payment processor](/assets/worldpay-payment-processor.327f33788a3b30fef7388eaa3b306fa8f7e987c68b3851ea880ef872ac63b179.39c0f7df.png)

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


![Payment Methods page screenshot](/assets/payment-methods.5359802ad1d40b45ba4afbad5eecd0fdf6dbfb7b4b44dd6b2f923a742bb4a172.39c0f7df.png)

## 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](/products/3ds-sca-exemptions#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](/assets/enable-threeds.b6997b49ff2341865ef010ab575bf974868e3d6d7f2974ad0811d70264688908.39c0f7df.png)

**Next steps**

[Optional configuration for your Plugin](/products/plugins/salesforce/configuration)
[Testing and Go live](/products/plugins/salesforce/testing-go-live)