Merchant Center custom application user guide
Learn how to use the Merchant Center custom application.
Last updated
Learn how to use the Merchant Center custom application.
Last updated
Once the Merchant Center Application is installed, complete configuration by finishing some initial settings as described below.
Set all required Digital River API keys and secrets before you use the connector. Refer to Create connector access keys for information on how to create/retrieve the keys.
Each key and secret can be entered using the API Keys sub-menu in the commercetools Digital River settings found in the commercetools Dashboard menus as shown in the following example:
Updated keys can be entered via the screen above. See the Digital River documentation on rotating keys for details of how to generate a new key and expire the old one.
Your new key is not used immediately. By default key, new values are cached for up to 10 minutes. This value is configurable.
Keys are refreshed immediately if an old key is no longer valid.
Digital River orders require a shipFrom address for their tax calculations. You must define at least one address. Each address can be defined in the Warehouse sub-menu in the commercetools Digital River settings as shown in the following example:
The ID that is used must be unique and will be used to link a cart to a warehouse. Refer to Authorize a payment for more information.
Existing addresses may be viewed and edited via the drop-down next to the New Address button.
Products are automatically synced to Digital River when they are published in commercetools. You can also perform a full manual sync. This is useful if you encounter sync errors or if the Digital River connector was installed after products were already entered in your catalog.
The Catalog Sync screen shows the details of the following:
Time of the last manual sync
Duration of the last manual sync
Indication of if a manual sync is running
Status of synchronization for all variants. This could be from a manual or automatic sync.
For each variant that is synced, a line appears in the table with the following data:
Product ID
The commercetools product id for the variant. Clicking this will open the product
Variant ID
The commercetools index for the variant. Clicking this will open the variant
Product Name
The name of the product
Request Data
Contents of the request sent to the Digital River API when syncing
Sync Time
Time of sync attempt
Response Data
Contents of the response received from Digital River API when syncing
Response Status
HTTP status of the response received from Digital River API when syncing
Success
Indicates if the sync was sucessful
The request and response data sections can be expanded using the arrow at the far right of the table row. These details are provided to help you diagnose any sync failures.
To filter sync results, select a filter and then type a string to match in the filter box. Only exact matches are supported. You can filter by the following:
Product name
Product id
Response status
The following is an example of filtering by response status:
Click Sync products on the commercetools Catalog Sync page to start a manual sync. The button changes to an indicator that the sync process is in progress
Sync results are not refreshed automatically. Click Refresh results to do this.
