Order lookup
Learn how to lookup orders.
You can retrieve your order. This request requires the anonymous shopper token, an order identifier (
orderId
), and an order password (password
).cURL
200 OK response
curl --location --request POST 'https://api.digitalriver.com/v1/shoppers/order-lookup?expand=all' \
--header 'authorization: Basic ***\
--header 'Accept: application/json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
...
--data-urlencode 'orderId=order_id' \
--data-urlencode 'password=order_password'
{
"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"
},
"payment": {
"paymentMethodName": "discover",
"displayableNumber": "************9876"
},
"orderState": "Complete",
"billingAddress": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/address/47278020023",
"id": "billingAddress",
"firstName": "Automation",
"lastName": "Tester",
"line1": "PO BOX 6930",
"line2": "123",
"line3": "Suite Line 3",
"city": "Waconia",
"countrySubdivision": "MN",
"postalCode": 5387,
"country": "US",
"countryName": "United States",
"phoneNumber": "099-222-44454",
"emailAddress": "[email protected]"
},
"shippingAddress": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/address/47278020023",
"id": "billingAddress",
"firstName": "Automation",
"lastName": "Tester",
"line1": "PO BOX 6930",
"line2": "123",
"line3": "Suite Line 3",
"city": "Waconia",
"countrySubdivision": "MN",
"postalCode": 5387,
"country": "US",
"countryName": "United States",
"phoneNumber": "099-222-44454",
"emailAddress": "[email protected]"
}
}
],
"totalResults": 1,
"totalResultPages": 1
}
}
You can retrieve a customer's current order. This request requires the customer's authenticated shopper token, email address, and the last four digits of their payment card.
cURL
200 OK response
curl --location --request POST 'https://api.digitalriver.com/v1/shoppers/order-lookup?expand=all' \
--header 'authorization: Basic ***\
--header 'Accept: application/json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
...
--data-urlencode 'creditCardLastDigits=last_4_digits_of_their_payment_card' \
--data-urlencode 'emailAddress=shopper's_email_address'
{"orders": {
"order": [ {
"uri": "https://api.digitalriver.com/v1/shoppers/me/orders/9999999999",
"id": 9999999999,
"submissionDate": "2016-11-02T14:25:06.000Z",
"locale": "en_US",
"testOrder": "false",
"pricing": {
"total": {
"currency": "USD",
"value": 13.88
},
"formattedTotal": "$13.88"
},
"payment": {
"paymentMethodName": "discover",
"displayableNumber": "************9876"
},
"orderState": "Complete",
"billingAddress": {
"id": "billingAddress",
"firstName": "John",
"lastName": "Doe",
"line1": "PO BOX 3940",
"city": "Waconia",
"countrySubdivision": "MN",
"postalCode": "55387",
"phoneNumber": "555-555-555",
"emailAddress": "[email protected]"
},
"shippingAddress": {
"id": "billingAddress",
"firstName": "John",
"lastName": "Doe",
"line1": "PO BOX 3940",
"city": "Waconia",
"countrySubdivision": "MN",
"postalCode": "55387",
"phoneNumber": "555-555-555",
"emailAddress": "[email protected]"
}
}],
"totalResults": 1,
"totalResultPages": 1
}}
Last modified 4mo ago