Transparent Commerce Purchase Flow

Use Transparent Commerce™ to instantly purchase a product on behalf of a shopper during an authenticated shopper session. This API bypasses calling the Apply Shopper and Submit Cart APIs separately and instantly purchases a single product. A typical example of a product purchased via this API is an auto-renewal, such as a subscription.

The product direct purchase API performs the following actions with one Shopper API call:

  1. Adds a product to the cart.
  2. Applies the default shopper address to the cart.
  3. Applies the default payment option to the cart.
  4. Submits the cart.
  5. Creates an order.

Prerequisite: The request must be made with a valid full access token. 

Request

Send a POST shoppers/me/products/{id}/purchase request with the specific product ID for the product that the shopper wants to purchase. The following request purchases a product with a product ID of 291233200:

POST https://api.digitalriver.com/v1/shoppers/me/products/291233200/purchase HTTP/1.1

Response

The response header contains a Location header, as shown on line 4, to the order that was created for the transaction. The ID of the order is 1234567890. The request and response bodies are empty.

1.  HTTP/1.1 201 Created
2.  Server: Apache
3.  X-Server-Name: server.xyz.digitalriverws.net
4.  Location: https://api.digitalriver.com/shoppers/me/orders/1234567890
6.  Content-Length: 0
7.  Accept-Ranges: bytes
8.  Date: Fri, 17 Jan 2014 16:46:30 GMT
9.  Age: 0
10. Access-Control-Allow-Origin: *

No further calls are required. If applicable, you can make follow-up calls to get the order by its ID or the order history for the shopper.