Configure the app

Learn how to configure the SAP Commerce Cloud app.

Step 1: Open/Update the Digital River configuration page

The Merchant application can relate to the Digital River system by configuring the settings below through Backoffice.

  • From Backoffice, expand Digital River in the left navigation and click the Digital River Config.

  • A configuration page with the attributes shown in the second image below will appear in the editor area.

  • Add or update the configuration details and click Save.

Attribute

Description

Code

Unique identifier for the configuration (for example, DR_US)

Active

Click true.

Merchant Public Key

Merchant’s public key from Digital River

Shared Secret

Merchant’s secret API key

End Point

Endpoint URL for the Digital River API call

Ship From

Provide the ship-from warehouse address for the store. If there are multiple warehouses, the merchant system needs to customize accordingly.

Step 2: Attach the base store configuration

After you create the Digital River configuration, attach the configuration to the corresponding Base store.

  1. Click the Base Store option from Base Commerce in Backoffice and select the appropriate Base Store.

  2. Select the Digital River configuration in the Digital River Configuration dropdown list.

  3. Select True for the External Tax Calculation attribute, and then click Save.

Note: The base store settings determine if the store displays the tax-inclusive pricing (Net set to false) or tax-exclusive pricing (Net set to true).

Step 3: Load the Digital River tax groups

Load the Digital River-supported tax groups in the merchant system for determining the tax code for SKU creation. See setting-the-tax-code for more details related to tax groups and types. To load and execute the existing tax groups from Digital River, copy the contents of the DRTaxImport.txt file (converted from *.ImpEx format) to the SAP Commerce HAC window.

Note: You will also receive the three *.ImpEx files referenced on this page from Digital River during implementation.

Step 4: Configure the product

Update the product’s required custom attributes listed in the following table before proceeding to checkout.

Attributes

Description

countryOfOrigin

The product’s country of origin.

eccn

The product’s Export Control Classification Number.

drTaxGroup

The product’s tax group.

drTaxType

The product’s tax group type.

drProductType

The type of product, either physical or digital.

You can update product attributes either through Backoffice or by using the following ImpEx example for a bulk update.

$productCatalog=electronicsProductCatalog
$productCatalogName=Electronics Product Catalog
$catalogVersion=catalogversion(catalog(id[default=$productCatalog]),version[default='Online'])[unique=true,default=$productCatalog:Online]
INSERT_UPDATE Product;code[unique=true]
;$catalogVersion;countryOfOrigin(isocode);eccn;drTaxGroup(taxGroup);drTaxType(drTaxType);drProductType(code)
;832382;;US;EAR99;Downloadable Goods (Non-Software);Digital Image;Digital

Step 5: Create SKUs and run cron jobs

SKU creation

Before performing this step, complete the Digital River Configuration, Base Store Configuration, Digital River Tax Group, and Product Configuration steps (Steps 1–4 previous).

To create SKUs for the Digital River system, run the following ImpEx. The ImpEx creates the cron job at the merchant application after updating the product catalog ID and store ID.

The cron job runs every five minutes and finds all approved products added or updated within the timeframe.

$siteUid=electronics
$storeUid=electronics
$productCatalog=electronicsProductCatalog
INSERT_UPDATE CreateSKUCronJob;code[unique=true];job(code)[default=createSKUJob];sessionLanguage(isoCode)[default=en];productCatalog;baseStore(uid)
;$siteUid-CreateSKUCronJob;;;$productCatalog;$storeUid
INSERT_UPDATE Trigger;cronJob(code)[unique=true];cronExpression
;$siteUid-CreateSKUCronJob;0 0/5 * 1/1 * ? *

Step 6: Run the confirmation email body template

We updated the template for an out of box order confirmation email to show the payment method from Digital River and digital product handling.

Run the following confirmation email body template after updating the respective content catalog name and version. To do so, copy the contents of the confirmation_email.txt file (converted from *.ImpEx format) to the SAP Commerce HAC window to load and execute the file.

Step 7: Add the Digital River compliance statement

The merchant system must show a Digital River compliance statement in the footer section of every checkout step. The Content Management System (CMS) component is available for integrating the compliance footer in the storefront.

  1. Download and run the following DR_footer.txt file, converted from *.ImpEx format.

  2. Change the content catalog name and version in the file and copy the file contents to the SAP Commerce HAC window.

  3. Load and execute the file. If you see any errors when updating the existing content slot, update the file contents from the Backoffice Web Content Management System (WCMS).

The showDRComplianceFooter method in digitalriveraddon.js will handle the loading for the compliance footer div in the CMS component.