feat: payment information as customer endpoint

Author: ahinkle

src/Api/Carts.php

@@ -58,7 +58,6 @@ public function shippingInformation($body = [])
     /**
      * Lists available payment methods for a specified shopping cart. This call returns an array of objects, but detailed information about each object’s attributes might not be included.
      *
-     * @param  array  $body
      * @return array
      */
     public function paymentMethods()
@@ -67,4 +66,17 @@ public function paymentMethods()
 
         return $this->get('/carts/mine/payment-methods');
     }
+
+    /**
+     * Set payment information and place order for a specified cart.
+     *
+     * @param  array  $body
+     * @return array
+     */
+    public function paymentInformation($body = [])
+    {
+        $this->validateSingleStoreCode();
+
+        return $this->post('/carts/mine/payment-information', $body);
+    }
 }

tests/Api/CartsTest.php

@@ -122,4 +122,26 @@ public function test_must_pass_a_single_store_code_to_payment_methods()
         $magento = new Magento();
         $magento->api('carts')->paymentMethods([]);
     }
+
+    public function test_can_call_carts_payment_information()
+    {
+        Http::fake([
+            '*rest/default/V1/carts/mine/payment-information' => Http::response([], 200),
+        ]);
+
+        $magento = new Magento();
+        $magento->storeCode = 'default';
+
+        $api = $magento->api('carts')->paymentInformation([]);
+
+        $this->assertTrue($api->ok());
+    }
+
+    public function test_must_pass_a_single_store_code_to_payment_information()
+    {
+        $this->expectException('exception');
+
+        $magento = new Magento();
+        $magento->api('carts')->paymentInformation([]);
+    }
 }