# Configure the Salesforce B2C LINK Cartridge

## Custom site preferences

After successfully importing the metadata, select **BM Merchant Tools**, select **Site Preferences**, and then select **Custom Preferences** to see **Custom Site Preferences Groups**.

<div align="left"><img src="https://675422414-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuSC5d0FqUtV9sJdb%2F-MS4Jq6d9mcZH5_DyXor%2F-MS4K-b0l6mr7VxmCugx%2FCustomSitePref.png?alt=media&#x26;token=3ad2cf93-2ece-4dc5-b55c-319a96d25119" alt=""></div>

Click **Digital River** to see the cartridge setup fields.&#x20;

<figure><img src="https://675422414-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS319Bk8ctoYdRdGulGmC%2Fuploads%2FuUfHGYGMVhEnYDM7tdoa%2Fwordshrink1.png?alt=media&#x26;token=aad6aaa5-ca37-4595-8104-1c8b06764145" alt=""><figcaption></figcaption></figure>

| Field Title                                   | Description                                                                                                                                                                                                                                                                                                                                                               |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enable Digital River                          | Turns on/off Digital River integration.                                                                                                                                                                                                                                                                                                                                   |
| \*API Key                                     | Digital River publishable API key.                                                                                                                                                                                                                                                                                                                                        |
| \*Digital River public key                    | Your public API key.                                                                                                                                                                                                                                                                                                                                                      |
| Webhook Signature Token                       | <p>The signing secret (signature token) used by the <a href="https://docs.digitalriver.com/digital-river-api/order-management/events-and-webhooks-1/webhooks">webhooks</a> to send notifications for events such as a refund event from SFCC endpoints. Each webhook has a unique signing secret.</p><p>Each site is configured with a single endpoint URI and token.</p> |
| \*\*Digital River ship from country           | The ship-from country for physical products. You can only configure a single ship from country per site under Site Preferences in the Business Manager.                                                                                                                                                                                                                   |
| Digital River ship from state                 | The ship-from state for physical products.                                                                                                                                                                                                                                                                                                                                |
| \*\*Digital River ship from city              | The ship-from city for physical products.                                                                                                                                                                                                                                                                                                                                 |
| \*\*Digital River ship from address line 1    | The ship-from address line 1 for physical products.                                                                                                                                                                                                                                                                                                                       |
| Digital River ship from address line 2        | The ship-from address line 2 for physical products.                                                                                                                                                                                                                                                                                                                       |
| \*\*Digital River ship from postal code       | The ship-from postal code for physical products.                                                                                                                                                                                                                                                                                                                          |
| Modified SKUs update requested                | The custom attribute (flag) updated from the Business Manager extension.                                                                                                                                                                                                                                                                                                  |
| Replace all promotions with one fixed amount. | <p>Replace all promotions with one fixed amount</p><p><strong>Important:</strong> Refer to <a href="../user-guide#tax-inclusive-sites-promotions-and-tax-identifiers">this information</a> before enabling.</p>                                                                                                                                                           |
| All SKUs update requested                     | The custom attribute (flag) updated from the Business Manager extension.                                                                                                                                                                                                                                                                                                  |
| Enable US Tax exemptions                      | Enable processing of tax certificates.                                                                                                                                                                                                                                                                                                                                    |
| Technical Email Address                       | The email address where the webhook notifications will be sent.                                                                                                                                                                                                                                                                                                           |
| Digital River Default Entity                  | The default selling entity used for compliance. Note that this value must match the [selling entity](https://docs.digitalriver.com/digital-river-api/integration-options/checkouts/creating-checkouts/selling-entities) format expected by the Digital River API and will be provided by Digital River.                                                                   |

\*Digital River provides the values for these fields.

\*\*Digital River requires these custom site preferences.

## Business Manager roles and permissions

To enable the Digital River Business Manager extensions, add the **Write** permission to the targeted access role. This is optional to enable the **Digital River Service Checker** and **Request SKUs** to update the modules.

In Business Manager, select **Administration**, and then select **Roles and Permissions**. To add the Digital River modules to a role, click the role you want to modify (or create a new one). Then click one or more checkboxes to select the **Business Manager** modules for that role.

<div align="left"><img src="https://675422414-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuSC5d0FqUtV9sJdb%2F-MS4Jq6d9mcZH5_DyXor%2F-MS4KJF8TJPsvqgBRMB7%2FBusMgrContext.png?alt=media&#x26;token=d4f51c4a-6bea-4abd-a6ec-15452624abb6" alt=""></div>

In the next menu, add the **Write** permission to the Digital River group as indicated below.

<div align="left"><img src="https://675422414-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuSC5d0FqUtV9sJdb%2F-MS4KiHW6rqcwIxf6R2t%2F-MS4KtqXkD4QSi3ZVHWd%2FBusMgrModule.png?alt=media&#x26;token=95645378-972d-4d60-8542-86fc8c969a6c" alt=""></div>

See [Business Manager](#business-manager) for more information about Digital River modules.

Lastly, the order status update job must be able to access the order to update the status of the order properly. To enable this job to function properly, you must change the site settings.

1. Select **Merchant Tools**, select **Site Preferences**, and click **Order**.
2. Set **Limit Storefront Order Access** to **No**.
3. Set **Storefront Order Filter by Customer Session** to **No**.&#x20;

<div align="left"><img src="https://675422414-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuSC5d0FqUtV9sJdb%2F-MS4KiHW6rqcwIxf6R2t%2F-MS4L2-LulQOB0JPxfbJ%2FORDERA~1.PNG?alt=media&#x26;token=21357b6d-395f-4e62-bfeb-33110201cf83" alt=""></div>

## Updating shipping methods to support digital products

In order to meet the SFCC requirement to have a shipping method for creating an order, add a dedicated digital shipping method for digital products with a specified price amount. Set the **Exclusions** of the shipping method (as shown below). &#x20;

<div align="left"><img src="https://675422414-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNZuSC5d0FqUtV9sJdb%2F-MkHllTGX2lFFdKWvUk9%2F-MkHmj3zoN_JHzXDjleW%2FDigital%20River%20Attributes.png?alt=media&#x26;token=9a3ba5d1-732c-4e1d-8058-b4fc01673e9d" alt=""></div>

Ensure that if the basket contains the products without the custom attribute`drDigitalProduct`and products where that attribute is set to`false`, this digital shipping method will not be applicable. Therefore, customers are unable to select this shipping method for mixed and non-digital carts.

{% hint style="info" %}
**Note**: All other existing shipping methods should be also configured so that they are not shown when there are only digital products in the basket. &#x20;
{% endhint %}
