Checkout Step 5: Complete Cart

In this guide, you'll learn how to complete the cart and place the order. This is the last step of your checkout flow.

How to Complete Cart in Storefront Checkout#

Once you finish any required actions with the third-party payment provider, you can complete the cart and place the order.

To complete the cart, send a request to the Complete Cart API route. For example:

TipLearn how to install and configure the JS SDK in the JS SDK documentation.
Code
1sdk.store.cart.complete(cart.id)2.then((data) => {3  if (data.type === "cart" && data.cart) {4    // an error occured5    console.error(data.error)6  } else if (data.type === "order" && data.order) {7    // TODO redirect to order success page8    alert("Order placed.")9    console.log(data.order)10    // unset cart ID from local storage11    localStorage.removeItem("cart_id")12  }13})

In the response of the request, the type field determines whether the cart completion was successful:

  • If the type is cart, it means the cart completion failed. The error response field holds the error details.
  • If the type is order, it means the cart was completed and the order was placed successfully.

When the cart completion is successful, it's important to unset the cart ID from the localStorage, as the cart is no longer usable.


React Example with Default System Payment Provider#

For example, to complete the cart when the default system payment provider is used:

TipThis example uses the useCart hook defined in the Cart React Context guide.
Code
1"use client" // include with Next.js 13+2
3import { useState } from "react"4import { useCart } from "@/providers/cart"5import { sdk } from "@/lib/sdk"6
7export default function SystemDefaultPayment() {8  const { cart, refreshCart } = useCart()9  const [loading, setLoading] = useState(false)10
11  const handlePayment = (12    e: React.MouseEvent<HTMLButtonElement, MouseEvent>13  ) => {14    e.preventDefault()15
16    if (!cart) {17      return18    }19
20    setLoading(true)21    22    // TODO perform any custom payment handling logic23    24    // complete the cart25    sdk.store.cart.complete(cart.id)26    .then((data) => {27      if (data.type === "cart" && data.cart) {28        // an error occured29        console.error(data.error)30      } else if (data.type === "order" && data.order) {31        // TODO redirect to order success page32        alert("Order placed.")33        console.log(data.order)34        refreshCart()35      }36    })37    .finally(() => setLoading(false))38  }39
40  return (41    <button42      onClick={handlePayment}43      disabled={loading}44    >45      Place Order46    </button>47  )48}

In the example above, you create a handlePayment function in the payment component. In this function, you:

  • Optionally perform any required actions with the third-party payment provider. For example, authorize the payment. For the default system payment provider, no actions are required.
  • Send a request to the Complete Cart API route once all actions with the third-party payment provider are performed.
  • In the received response of the request, if the type is cart, it means that the cart completion failed. The error is set in the error response field.
  • If the type is order, it means the card was completed and the order was placed successfully. You can access the order in the order response field.
  • When the order is placed, you must unset the cart_id from the localStorage. You can redirect the customer to an order success page at this point. The redirection logic depends on the framework you're using.

React Example with Third-Party Payment Provider#

Refer to the Stripe guide for an example on integrating a third-party provider and implementing card completion.

Was this page helpful?
Ask Anything
FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break