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 cartridge setup fields.
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.
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 format expected by the Digital River API and will be provided by Digital River.
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 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.
In the next menu, add the Write permission to the Digital River group 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 status of the order properly. To enable this job to function properly, you must change the site settings.
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
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).
Ensure that if the basket contains the products without the custom attributedrDigitalProductand products where that attribute is set tofalse, this digital shipping method will not be applicable. Therefore, customers are unable to select this shipping method for mixed and non-digital carts.
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.
