How does an order placement work for a guest customer?

dmitry_fedyuk · March 2, 2016, 10:54pm

Preliminary context: how does the Magento_Checkout/js/view/payment/default's placeOrder() work?

magento/magento2/blob/cf7df72/app/code/Magento/Checkout/view/frontend/web/js/action/place-order.js#L22-L40


if (!customer.isLoggedIn()) {
    serviceUrl = urlBuilder.createUrl('/guest-carts/:quoteId/payment-information', {
        quoteId: quote.getQuoteId()
    });
    payload = {
        cartId: quote.getQuoteId(),
        email: quote.guestEmail,
        paymentMethod: paymentData,
        billingAddress: quote.billingAddress()
    };
} else {
    serviceUrl = urlBuilder.createUrl('/carts/mine/payment-information', {});
    payload = {
        cartId: quote.getQuoteId(),
        paymentMethod: paymentData,
        billingAddress: quote.billingAddress()
    };
}

github.com

magento/magento2/blob/cf7df72/app/code/Magento/Checkout/etc/webapi.xml#L65-L71


<!-- Guest place order with payment information saving -->
<route url="/V1/guest-carts/:cartId/payment-information" method="POST">
    <service class="Magento\Checkout\Api\GuestPaymentInformationManagementInterface" method="savePaymentInformationAndPlaceOrder"/>
    <resources>
        <resource ref="anonymous" />
    </resources>
</route>

github.com

magento/magento2/blob/cf7df72/app/code/Magento/Checkout/Api/GuestPaymentInformationManagementInterface.php#L14-L29


/**
 * Set payment information and place order for a specified cart.
 *
 * @param string $cartId
 * @param string $email
 * @param \Magento\Quote\Api\Data\PaymentInterface $paymentMethod
 * @param \Magento\Quote\Api\Data\AddressInterface|null $billingAddress
 * @throws \Magento\Framework\Exception\CouldNotSaveException
 * @return int Order ID.
 */
public function savePaymentInformationAndPlaceOrder(
    $cartId,
    $email,
    \Magento\Quote\Api\Data\PaymentInterface $paymentMethod,
    \Magento\Quote\Api\Data\AddressInterface $billingAddress = null
);

github.com

magento/magento2/blob/cf7df72/app/code/Magento/Checkout/Model/GuestPaymentInformationManagement.php#L12-L12


class GuestPaymentInformationManagement implements \Magento\Checkout\Api\GuestPaymentInformationManagementInterface

github.com

magento/magento2/blob/cf7df72/app/code/Magento/Checkout/Model/GuestPaymentInformationManagement.php#L73-L86


public function savePaymentInformationAndPlaceOrder(
    $cartId,
    $email,
    \Magento\Quote\Api\Data\PaymentInterface $paymentMethod,
    \Magento\Quote\Api\Data\AddressInterface $billingAddress = null
) {
    $this->savePaymentInformation($cartId, $email, $paymentMethod, $billingAddress);
    try {
        $orderId = $this->cartManagement->placeOrder($cartId);
    } catch (\Exception $e) {
        throw new CouldNotSaveException(__('Cannot place order'), $e);
    }
    return $orderId;
}

Further reading: how does a payment information saving work when a guest customer places an order?

dmitry_fedyuk · March 2, 2016, 11:01pm