Order lookup

Get your orders

To check a shopper's order status, you can use one of the following methods:

1. Provide an authenticated shopper token, credit card last digits, and email address.
2. Provide an anonymous shopper token, credit card last digits, and email address.
3. Provide an anonymous shopper token, order ID, and password.

POSThttps://api.digitalriver.com/v1/shoppers/order-lookup

Query parameters

Body

application/x-www-form-urlencoded

creditCardLastDigitsstring

Provide the last four digits of the shopper's credit card.

emailAddressstring

Provide the shopper's email address. The emailAddress requires the creditCardLastDigits.

orderIdstring

Provide the shopper's order identifier. The orderId requires a password.

passwordstring

Provide the shopper's password.

Response

200401

Successful response.

Body

application/json

one of

DefaultOrderLookup (object)ExpandedOrderLookup (object)

Request

JavaScriptCurlPython

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

Response

200401

{
  "orders": {
    "order": [
      {
        "uri": "https://api.digitalriver.com/v1/shoppers/me/orders/100009222210019",
        "id": 100009222210019,
        "submissionDate": "2018-05-04T17:12:17.000Z",
        "pricing": {
          "total": {
            "currency": "USD",
            "value": "19.99"
          },
          "formattedTotal": "$13.95"
        },
        "paymentMethod": {
          "type": "creditCard",
          "sourceId": "a231f38d-3a07-4a13-96ed-89693ba7d56c",
          "sourceClientSecret": "a231f38d-3a07-4a13-96ed-89693ba7d56c_f6d8c951-59c9-4ef3-ac45-9f33c77d2f46",
          "creditCard": {
            "expirationYear": "2030",
            "lastFourDigits": "0000",
            "clientSecret": "a231f38d-3a07-4a13-96ed-89693ba7d56c_f6d8c951-59c9-4ef3-ac45-9f33c77d2f46",
            "expirationMonth": "08",
            "fundingSource": "debit",
            "brand": "Visa",
            "reusable": "true"
          },
          "amountContributed": {
            "currency": "USD",
            "value": 1059.5
          },
          "charges": [
            {
              "chargeId": "1cac37c0-98a7-46b2-b9ed-fbc615c9f18a",
              "amount": {
                "currency": "USD",
                "value": 1059.5
              },
              "status": "failed",
              "createdTime": "2021-12-06T09:03:46.877Z",
              "updatedTime": "2021-12-06T09:03:46.877Z"
            }
          ],
          "supplementaryPaymentMethods": [
            {
              "type": "customerCredit",
              "sourceId": "a231f38d-3a07-4a13-96ed-89693ba7d56c",
              "sourceClientSecret": "a231f38d-3a07-4a13-96ed-89693ba7d56c_f6d8c951-59c9-4ef3-ac45-9f33c77d2f46",
              "customerCredit": {
                "flow": "standard",
                "reusable": "true"
              },
              "charges": [
                {
                  "chargeId": "cf57f9c9-8b0d-4e64-998a-816499fefa01",
                  "amount": {
                    "currency": "USD",
                    "value": 1059.5
                  },
                  "status": "failed",
                  "createdTime": "2021-12-06T09:03:46.877Z",
                  "updatedTime": "2021-12-06T09:03:46.877Z"
                }
              ],
              "amountContributed": {
                "currency": "USD",
                "value": 1059.5
              }
            }
          ]
        },
        "payment": {
          "paymentMethodName": "discover",
          "displayableNumber": "************4321",
          "expirationMonth": "08",
          "expirationYear": "2030",
          "customerFirstName": "AUTOMATION",
          "customerLastName": "TESTER",
          "customerEmail": "[e-mail]",
          "paymentAmount": {
            "currency": "USD",
            "value": "19.99"
          },
          "softDescriptor": "DRI*demosft1"
        },
        "orderState": "Complete",
        "billingAddress": {
          "uri": "https://api.digitalriver.com/v1/shoppers/me/address/47278020023",
          "relation": "https://developers.digitalriver.com/v1/shoppers/AddressesResource",
          "id": "billingAddress",
          "firstName": "Automation",
          "lastName": "Tester",
          "companyName": "Digital River",
          "line1": "PO BOX 6930",
          "line2": "123",
          "line3": "Suite Line 3",
          "city": "Waconia",
          "countrySubdivision": "MN",
          "postalCode": "5387.0",
          "country": "US",
          "countryName": "United States",
          "phoneNumber": "099-222-44454",
          "emailAddress": "[e-mail]",
          "countyName": "Hennepin",
          "phoneticFirstName": "クリス",
          "phoneticLastName": "ミラー",
          "division": "製品開発",
          "title": "M"
        },
        "shippingAddress": {
          "uri": "https://api.digitalriver.com/v1/shoppers/me/address/47278020023",
          "relation": "https://developers.digitalriver.com/v1/shoppers/AddressesResource",
          "id": "shippingAddress",
          "firstName": "Automation",
          "lastName": "Tester",
          "companyName": "Digital River",
          "line1": "PO BOX 6930",
          "line2": "123",
          "line3": "Suite Line 3",
          "city": "Waconia",
          "countrySubdivision": "MN",
          "postalCode": "5387.0",
          "country": "US",
          "countryName": "United States",
          "phoneNumber": "099-222-44454",
          "countyName": "Hennepin",
          "emailAddress": "[e-mail]",
          "phoneticFirstName": "クリス",
          "phoneticLastName": "ミラー",
          "division": "製品開発"
        },
        "paymentSession": {
          "id": "text",
          "status": "text",
          "clientSecret": "text",
          "redirectUrl": "https://api.digitalriver.com:80/payments/redirects/12759bb0-xxxx-4bdb-bfeb-9095ba8059fc?apiKey=a88fxxxx1eef47eb95bc609c22e593c8"
        },
        "customerType": "B",
        "taxRegistrations": [
          {
            "key": "UK_VAT",
            "value": "GB698588737"
          }
        ]
      }
    ],
    "totalResults": 1,
    "totalResultPages": 1
  }
}