Manage a shopper

Get the current shopper

Retrieve shopper data for both anonymous and authenticated shoppers.

GEThttps://api.digitalriver.com/v1/shoppers/me

Query parameters

Response

200401409

Successful response.

Body

application/json

one of

DefaultShopper (object)ExpandedShopper (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.digitalriver.com/v1/shoppers/me', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401409

{
  "shopper": {
    "uri": "https://api.digitalriver.com/v1/shoppers/me",
    "id": 489475657389,
    "username": "[e-mail]",
    "firstName": "Automation",
    "lastName": "Tester",
    "emailAddress": "[e-mail]",
    "paymentOptions": {
      "uri": "https://api.digitalriver.com/v1/shoppers/me/payment-options"
    },
    "addresses": {
      "uri": "https://api.digitalriver.com/v1/shoppers/me/addresses"
    },
    "orders": {
      "uri": "https://api.digitalriver.com/v1/shoppers/me/orders"
    },
    "subscriptions": {
      "uri": "https://api.digitalriver.com/v1/shoppers/me/subscriptions"
    }
  }
}

Update the current shopper

The type of access token used to update a shopper's information determines the extent of information that you can update. If the access token is anonymous, only an anonymous shopper's locale, IP address, and currency can be updated. An authenticated shopper token is required to update any other information. With an authenticated shopper token, you have comprehensive control over shopper information, including the ability to update the username and password for an authenticated shopper.

POSThttps://api.digitalriver.com/v1/shoppers/me

Query parameters

Body

application/json

shopperobject

Response

204400401409

No Content

Request

JavaScriptCurlPython

const response = await fetch('https://api.digitalriver.com/v1/shoppers/me', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

400401409

{
  "errors": {
    "error": [
      {
        "code": "invalid-request",
        "description": "Invalid Request Content"
      }
    ]
  }
}

Create a shopper (Client-hosted shopper)

Create a Digital River partner-maintained shopper.

POSThttps://api.digitalriver.com/v1/shoppers (Client hosted shopper)

Query parameters

Body

application/json

shopperobject

Response

201400401409

• Created (Empty Response)
• Created (With additional information, contact the Digital River team for setup.)

Body

application/json

one of

EmptyResponse (string)DefaultClientHostedShopper (object)ExpandedClientHostedShopper (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.digitalriver.com/v1/shoppers (Client hosted shopper)', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201400401409

This will be empty response.

Create a shopper (Digital River hosted shopper)

Create a Digital River maintained shopper.

POSThttps://api.digitalriver.com/v1/shoppers (DR hosted shopper)

Query parameters

Body

application/json

shopperobject

Response

201400401409

• Created (Empty Response)
• Created (With additional information, contact the Digital River team for setup.)

Body

application/json

one of

EmptyResponse (string)DefaultShopper (object)ExpandedShopper (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.digitalriver.com/v1/shoppers (DR hosted shopper)', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201400401409

This will be empty response.