Checkout Flow

await storefront.cart.update("loc_123", cartId, {
  fulfillmentMethod: "takeout",
});

await storefront.cart.updateOrderTime("loc_123", cartId, {
  pickupType: "ASAP",
});

await storefront.cart.validateAndUpdateCustomer("loc_123", cartId, {
  customerName: "Alex Johnson",
  emailAddress: "alex@example.com",
  phoneNumber: "+1234567890",
});

const payment = await storefront.checkout.createPaymentSession(
  "loc_123",
  cartId,
  { idempotencyKey: crypto.randomUUID() },
);

curl -X POST "https://api.craveup.com/api/v1/storefront/locations/loc_123/carts/cart_456/payment-session" \
  -H "X-Cart-Token: $CART_ACCESS_TOKEN" \
  -H 'If-Match: "cart-4"' \
  -H "Idempotency-Key: payment_01"

const { error } = await stripe.confirmPayment({
  elements,
  confirmParams: {
    return_url: `${window.location.origin}/order/confirmation`,
  },
});

const result = await storefront.checkout.getOrderResult("loc_123", cartId);

switch (result.state) {
  case "payment_pending":
  case "order_pending":
    // Poll again with bounded backoff.
    break;
  case "completed":
    // Render result.order, then clear persisted cart capability state.
    break;
  case "failed":
    // Show a retry-safe failure using result.code, then clear terminal state.
    break;
}