Create order API endpoint (#607)

* added a custom create order API endpoint

* update order creation flow

* updated endpoint url

* update order creation flow

* apply payment method

* update php doc

* clean up

* clean up

* fix tests

* add dependency on Magento_Quote

* update phpdoc

* removed store ID, renamed class and interface

* updated di.xml and webapi.xml

* use placeOrder

* revert changes made by in the last commit, port some of the extra checks from  into

* set remote address and checkout session in our method like it is done in placeOrder in QuoteMagagement.php

* minor changes as requested in code review

* revert to get from getActive

* fix static tests failure

* suppress warnings

* resolve static test issues

* update parameters to match the request body structure

* 1. wrap logic inside a try/catch
2. Add request authentication

* fix static test issues

* fix more static test errors

* remove extra space

---------

Co-authored-by: Ameya Savale <[email protected]>

Author: zlik

app/code/Meta/Sales/Api/CreateOrderApiInterface.php

@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+namespace Meta\Sales\Api;
+
+use Magento\Sales\Api\Data\OrderInterface;
+
+/**
+ * Create Magento order
+ */
+interface CreateOrderApiInterface
+{
+    /**
+     * Create order
+     *
+     * @param string $cartId
+     * @param string $orderId
+     * @param string $email
+     * @param string $firstName
+     * @param string $lastName
+     * @param string|null $channel
+     * @param bool $buyerOptin
+     * @param bool $createInvoice
+     * @return OrderInterface
+     */
+    public function createOrder(
+        string  $cartId,
+        string  $orderId,
+        string  $email,
+        string  $firstName,
+        string  $lastName,
+        ?string $channel,
+        bool    $buyerOptin = false,
+        bool    $createInvoice = false
+    ): OrderInterface;
+}