Checkouts

Understand the purpose and the basic structure of the Checkout object

Checkouts manage the flow of the overall checkout process. When coupled with Drop-in, they can power your customer's checkout experience, from product selection to order placement. The Checkout object returns critical data points, such as shipping amount, applicable taxes and fees, discounts, and total cost, that customers need to evaluate before they make a purchasing decision.

Checkouts allow you to create, retrieve, update and delete individual checkouts, as well as perform requests to return a list of checkouts.

The high-level flow of a Checkout generally adheres to the following pattern:

  1. Customer selects one or more SKUs from your storefront.

  2. You create a Checkout that is associated with the selected SKUs.

  3. Customer provides payment details via DigitalRiver.js or Drop-in.

  4. You update the Checkout with the payment sourceId returned by DigitalRiver.js or Drop-in.

  5. Digital River returns the updated Checkout to you with taxes calculated and amounts totaled.

  6. Customer reviews the checkout details and decides whether to make the purchase.

You can also associate the Checkout with a Customer and a Source. When you provide a customerIdvalue, the email and ship-to address associated with that Customer are used in the Checkout. However, any values provided by the customer during the checkout process override the values retrieved from the Customer object.