System status
Search…
Commerce API
Getting started
Best practices
Test and use cases
Consumer browsing experience
Cart
Orders
Sites
Customers
Subscriptions
Fulfillment
Private store
Events and webhooks
File management
Returns and refunds
Error codes
Payment integrations
Resources
Release notes
API reference
Partner integrations
Postman collection
Subscribe to updates
Powered By GitBook
Getting started
Learn the basics of the Commerce API, how to obtain your credentials, and start making requests.

Basic information

The Commerce API is a RESTful API. That means we designed the API to allow you to create, read, update, and delete objects with thePOST, GET, PUT, and DELETE HTTP methods.
The Commerce API speaks mainly in JSON. To ensure the API accepts and processes your requests, you'll typically set the content-type header to application/json .
All Commerce API requests are sent to https://api.digitalriver.com.
For more information on how Digital River ensures high availability and performance, see our Service Level Agreement.

Quick start guide

This guide shows you how to start making Commerce API requests. By the end, you'll know how to obtain your API keys, import the Postman collection, and run each request. This collection provides the basic requests necessary to submit a simple order through the Commerce API.

Step 1: Obtain API credentials

Before you can start making Commerce API requests, you'll need to either contact your account manager or use the Request Demo form to request your API keys.
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 live 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 obtain your API keys, you'll want to perform some test requests. The following steps demonstrate how to do this:
Make sure you install Postman before proceeding.
  1. 1.
    Go to the Commerce API Postman Collection page on GitHub.
  2. 2.
    To install the Commerce API Postman Collection, click the Run in Postman button and select Postman for Windows.
  3. 3.
    Click the
    icon on the Commerce API Quick Start collection you just imported and select Edit.
  4. 4.
    In the Edit Collection window, select Variables.
  5. 5.
    Using the Current Value fields, enter the appropriate API key for each variable, and click Update.
  6. 6.
    Run each request individually or use the collection runner to run each one sequentially.
Now that you've successfully performed a series of simple test requests, you're ready to take a deeper dive into the Commerce API.
Previous
Commerce API
Next
Best practices
Last modified 1yr ago
Copy link
Contents
Basic information
Quick start guide
Step 1: Obtain API credentials
Step 2: Perform a test request