Getting started

Learn how to how to make Digital River API requests.

To get started with the Digital River API, you'll need to set up an account, obtain your API keys, and perform a test request. This guide will walk you through the necessary steps, ensuring you have everything in place to start making successful API calls to Digital River's platform. By following these instructions, you'll be well on your way to integrating Digital River's services into your application.

Step 1: Create a test account

Before sending Digital River API requests, you must create a test account in the Digital River Dashboard.

You can access your account's API keys once you successfully sign in to the Digital River Dashboard. Digital River provides four keys for your account: a public and confidential API Key for sending requests in both test and production modes. In the Digital River 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 an incorrect or outdated one, the API returns an error.

Step 2: Perform a test request

You can send a test request when you have your API keys. The following steps demonstrate how to do this:

Make sure you install Postman before proceeding.

1. Go to the Digital River API Postman Collection page on GitHub.

2. To install the Digital River API Postman Collection, click the Run in Postman button and select Postman for Windows.

3. Click the icon on the Digital River Collection you just imported and select Edit.

4. In the Edit Collection window, select the Variables tab.

5. For the secretKey variable, paste your confidential test key into the Initial Value and Current Value fields.

6. Click Save.

7. Back in the collection, expand the Create a Client-fulfilled SKU folder and open the Create a physical sku request.

8. Click Send. A successful request creates a SKU, and the response contains a 201 Created status code.

Step 3: Explore integration options

After successfully performing a simple test, you can dive deeper.

To better understand 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:

• Low-code checkouts: The quickest, easiest way to integrate. Add a turnkey Digital River-hosted checkout experience with minimal code or construct unique checkout flows with our components.

• Direct Integrations: A more customizable way to build your user experience. Use our ready-to-display features and flexible API suite.

• Connectors: Pre-built partner integrations allow you to connect with Digital River's payment processing, fraud detection, tax exemption, and disclosure services.