Getting started

Learn how to make Digital River API requests.
This guide shows you how to start making Digital River API requests. By the end, you'll know how to set up a Dashboard account, obtain your API keys, and perform a test request.

Step 1: Create a test account

Before you can start making Digital River API requests, you'll need to create a test account in the Dashboard.
Once you successfully sign in to Dashboard, you'll be able to access your account's API keys. Your account is provided with four keys in total: a public and confidential API Key for sending requests in both test and production modes. In Dashboard, toggle between Test and Production to view your public keys and click Reveal test token or Reveal token to unmask your confidential key.
Digital River uses these keys to authenticate your API requests. The API key you use to authenticate the request determines whether the request is in production mode or test mode. If you forget to provide your key or use one that is incorrect or outdated, the API returns an error.

Step 2: Perform a test request

After you have access to your API keys, you'll want to perform a test request. The following steps demonstrate how to do this:
Make sure you install Postman before proceeding.
  1. 1.
    Go to the Digital River API Postman Collection page on GitHub.
  2. 2.
    To install the Digital River API Postman Collection, click the Run in Postman button and select Postman for Windows.
  3. 3.
    Click the
    icon on the Digital River Collection you just imported and select Edit.
  4. 4.
    In the Edit Collection window, select the Variables tab.
  5. 5.
    For the secretKey variable, paste your confidential test key into the Initial Value and Current Value fields.
  6. 6.
    Click Save.
  7. 7.
    Back in the collection, expand the Create a Client-fulfilled SKU folder and open the Create a physical sku request.
  8. 8.
    Click Send. A successful request creates a SKU and the response contains a 201 Created status code.

Step 3: Explore integration options

Now that you've successfully performed a simple test request, you're ready to take a deeper dive.
To gain a better understanding of some of Digital River's core services and how to use them, we recommend you look over the Using our services page.
We also offer several integration paths to match your business needs:
  • Prebuilt Checkout: A low-code, pre-built checkout and payments experience that doesn't require extensive front-end development
  • Direct Integrations: A more customizable way to build checkout and payment experiences. This option allows you to use our secure, front-end components and flexible API suite.
  • Connectors: Pre-built partner integrations that allow you to connect with Digital River's payment processing, fraud detection, tax exemption, and disclosure services.