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.
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.
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 | CurrencyA 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.
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.
The default selling entity is used for compliance. Note that this value must match the format expected by the Digital River API and will be provided by Digital River.
