Configure Digital River shipping options
Learn how to configure Digital River shipping options.
Use the integrated Digital River’s Global Logistics (shipping options) feature with this extension. You can configure the extension to let shoppers select from shipping options that provide cross-border shipping through Digital River global logistics providers.
Shipping options best practices
Keep in mind the following when configuring and using Digital River shipping options:
You cannot apply native SFCC shipping promotions to only specific Digital River shipping options. Digital River shipping options use a single default SFCC (Salesforce Commerce Cloud) shipping method per currency on the backend. Therefore, you can only apply native SFCC shipping promotions to all Digital River Shipping methods in a specific currency. Use the
modifyShippingQuotes
function to adjust pricing on specific shipping methods.The merchant must ensure that when using the Digital River shipping options in Native or Both modes, there exists a valid SFCC default native shipping method for any address per currency. Otherwise, SFRA (Storefront Reference Architecture) will not function properly.
When Digital River shipping options are enabled, the user cannot select shipping methods on the Cart show page. This occurs because shipping options rely on complete address data not yet on the Cart page.
Digital River shipping options are not applicable to digital products. If the shopper has put only digital products in their basket, the Digital River shipping options are not displayed, and native methods are used instead.
Configuring Digital River shipping options
Complete the following steps to configure Digital River shipping options:
1. Configure the shipping option site preference
Configure one site preference (set it at site level) when using Digital River Shipping Options. Choose from the following available options:
Native SFCC methods only (native): Choose this option to turn off the Digital River Shipping Options feature and display only native SFCC shipping methods.
DR Shipping Quotes methods only (quotes): Choose this option to display only Digital River Shipping Options.
Native SFCC and DR Shipping Quotes methods (both): Choose this option to display both Digital River shipping options and native SFCC shipping methods.
2. Create the shipping option method
When using shipping options, the merchant must also create a shipping method named DRDefaultShpXXX
where XXX
is the uppercase ISO currency code for each currency used on the site. See Update shipping methods to support Digital River shipping options.
3. Enable the custom cache
Natively, SFRA makes frequent calls to update available shipping methods. To optimize performance when using the Digital River Shipping Options feature, you can enable the custom cache provided by the cartridge. Enable the custom cache by going to BM Administration> Operations> Custom Caches.
Customizing shipping options with the modifyShippingQuotes function
Use the modifyShippingQuotes
function in the drShippingQuotesHelper
script to modify the Digital River Shipping Options before being presented to the shopper. For example, you can filter the array of shipping options to display only those using DDP (or DAP) shipping terms. You can also modify the shippingCost
to offer the shopper a discount on shipping costs.
Find the script at the following location:
int_digitalriver\cartridge\scripts\digitalRiver\drShippingQuotesHelper.js
Note: You should override the modifyShippingQuotes
function in a custom cartridge.
In this script, the quotes
parameter in the modifyShippingQuotes
function contains an array of shipping quotes provided by Digital River. This array is structured the same as the filteredMethods
array in the SFRA getApplicableShippingMethods
function.
While you have control to modify any element of the array, you should limit your changes to filtering shipping options (removing any shipping options that should not be displayed to the shopper) and changing the shippingCost
of a shipping option (for example, offering free shipping for a particular shipping option).
Last updated