Configure the Salesforce B2C LINK Cartridge

Set up the Salesforce B2C LINK Cartridge and Business Manager.

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.

Click Digital River to see the Digital River Custom Site Preferences Group page. The following table provides information on each listed Digital River Custom Site Preference, including its supported values and options:

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	The signing secret (signature token) used by the webhooks to send notifications for events such as a refund event from SFCC endpoints. Each webhook has a unique signing secret. Each site is configured with a single endpoint URI and token.
**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.	Replace all promotions with one fixed amount Important: Refer to this information before enabling.
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 is used for compliance. Note that this value must match the selling entity format expected by the Digital River API and will be provided by Digital River.
Tax codes for Digital River products	Tax codes for offered products. Refer also to Tax-inclusive sites, promotions, and tax identifiers.
Replace all promotions with one fixed amount.	Refer to Tax-inclusive sites, promotions, and tax identifiers.
Digital River Drop In payment redirect option	Turns the payment redirect flow on or off. The default setting is Yes. If Yes is selected, the Drop-in configuration sets the disableAutomaticRedirects flag to True. The payment charge for the redirect payment type is made only when the order is placed and the redirect is completed. The Salesforce order is placed once the Digital River order been placed. The user is then redirected to payment processing. If the payment is successful, the user sees a Thank You page or is redirected back to the payment selection page. If option is set to No, the Drop-in configuration is not included with disableAutomaticRedirects option. The payment charge for a redirected payment type is made before an order is placed.
Digital River Enable Dynamic Pricing	Enable or disable the dynamic pricing feature.
Shipping Method Availability	Specifies one of the following shipping method options: Native SFCC methods only (native): This is the only operational method we support. Important: Only choose this method.
Digital River List Converted Price Book Naming	Specifies the naming pattern of list price books generated by the dynamic pricing job. The naming convention must contain the {COUNTRY} and {CURRENCY} placeholder tokens otherwise the price books will not be generated.
Digital River Sale Converted Price Book Naming	Specifies the naming pattern of sale price books generated by Dynamic Pricing job. The naming convention must contain the {COUNTRY} and {CURRENCY} placeholder tokens otherwise the price books will not be generated.
Digital River Batch Size	Specifies the number of items to send in the Dynamic Pricing API call. The default number is 50. However, this setting has been tested against batches of 500 and 1000 or more. You should test and optimize the batch size based on the resource allocation of the SFCC instance.
Digital River Shipping Options - Free Shipping Option	Specifies one or more shipping method IDs to which free shipping should be applied. You can add a single value or a comma-delimited list of values.
DR Flat Rate Shipping Configuration	Specifies the fixed price ranges for Digital River shipping methods. Add one setting entry per line in the text box and use the following format: Min Shipping Option Price | Max Shipping Option Price | Desired Shipping Option Price | DR Shipping Option ID | DR Shipping Terms | Currency A wildcard character (*) can be used instead of a minimum or maximum shipping method price. The following are examples of settings for this preference: *|*|10.99|ups_next_day_air|DDP|EUR *|250|100.11|ups_worldwide_expedited|DDP|EUR 250.01|*|199.11|ups_worldwide_expedited|DDP|EUR
Digital River Send Product Details	Set to True to send product attributes in the checkouts request. Set to False to use the SKU sync job. The default value is true.
Cancellable States	The order states where it is permissible to cancel the order. This DigitalRiver_CancelAbandonedOrders job uses this setting to determine which order to cancel. The job only cancels orders matching the acceptable states and specified criteria.
The lifespan of DROrderCancellationOnError Request custom objects	This setting defines the lifespan, in days, of DROrderCancellationOnErrorRequest custom objects in the system. It determines the retention span for these objects before automatically deleting them after the specified retention period.

*Digital River provides the values for these fields.

**Digital River requires these custom site preferences.

Custom global preferences

After successfully importing the metadata, select Administration, select Global Preferences, and then select Custom Preferences to see Custom Global Preferences Groups

Click Digital River to see the cartridge setup fields.

Field title	Description
Digital River API Key	Contains the private API key that will be used by the service when operating in organization mode.
Digital River Base Currency Code	Configure the base currency used for Dynamic Pricing conversion. This currency code must match the currency configured on Digital River platform.

Business Manager roles and permissions

Grant the Write permission to the relevant access role to enable the Digital River Business Manager extensions. This step is optional but necessary for enabling the Digital River Service Tester, requesting SKU updates, and configuring Supported Country Currency Pairs.

Go to Administration in Business Manager, then select Roles and Permissions. Choose the role you wish to modify or create a new one. Select the appropriate checkboxes for the Business Manager modules related to Digital River.

Add the Write permission to the Digital River group in the next menu, as indicated below.

See 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 order's status properly. You must change the site settings to enable this job to function properly.

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.

Updating shipping methods to support digital products

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).

If the basket contains the products without the custom attributedrDigitalProductand products where that attribute is setfalse, this digital shipping method will not be applicable. Therefore, customers cannot select this shipping method for mixed and non-digital carts.

Note: You should configure all other shipping methods so they do not appear when only digital products are in the basket.

Update currencies to support dynamic pricing.

Merchants need to update their currencies if they use the dynamic pricing feature. They must enable all currencies they will use on the site if they want to use dynamic pricing.