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 | |
Tax codes for Digital River products | |
Replace all promotions with one fixed amount. | |
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 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 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:
|
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 |
The lifespan of DROrderCancellationOnError Request custom objects | This setting defines the lifespan, in days, of |
*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.
Select Merchant Tools, select Site Preferences, and click Order.
Set Limit Storefront Order Access to No.
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.
Last updated
