Разработка экрана оформления заказа (Checkout) для интернет-магазина

Разработка экрана оформления заказа (Checkout) для интернет-магазина

Checkout — самый конверсионно критичный экран в e-commerce. Любая лишняя секунда загрузки, непонятное поле или ошибка валидации напрямую влияют на доход. Разработка полноценного checkout занимает от 5 до 10 рабочих дней: это один из самых сложных компонентов магазина.

Структура и шаги checkout

Классический многошаговый checkout состоит из следующих этапов:

1. Контактные данные — email, телефон (для SMS/звонка при проблемах с заказом)
2. Адрес доставки — поля адреса с автодополнением через DaData или Google Places API
3. Способ доставки — список вариантов с реальными ценами и сроками
4. Способ оплаты — карта, наличные, рассрочка, электронные кошельки
5. Подтверждение — итоговый просмотр, применение купонов, согласие с условиями

Альтернатива — одностраничный checkout (см. отдельную услугу). Многошаговый лучше работает для сложных заказов с несколькими вариантами доставки.

Автодополнение адреса

Интеграция с DaData для рынков СНГ:

const suggestAddress = async (query: string) => {
  const res = await fetch('https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/address', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Token ${DADATA_API_KEY}`,
    },
    body: JSON.stringify({ query, count: 5, locations: [{ country: 'Россия' }] }),
  });
  const data = await res.json();
  return data.suggestions;
};

После выбора подсказки поля города, улицы, индекса заполняются автоматически. Валидация адреса включает проверку на доставляемость конкретным перевозчиком.

Расчёт доставки в реальном времени

При выборе адреса и смене метода доставки тарифы запрашиваются в реальном времени через API перевозчиков. Для СДЭК:

$cdek = new \CdekSDK2\Client($clientId, $clientSecret);
$calculation = $cdek->tariffList([
    'type' => 1,
    'from_location' => ['code' => $warehouseCdekCityCode],
    'to_location' => ['address' => $shippingAddress],
    'packages' => [['weight' => $totalWeight, 'length' => 20, 'width' => 15, 'height' => 10]],
]);

Результаты кешируются на 10 минут — тарифы не меняются чаще. Если API перевозчика недоступен, показываем фиксированную «безопасную» стоимость с пометкой «уточняется».

Управление состоянием checkout

Состояние checkout должно переживать перезагрузку страницы — пользователь не должен вводить данные заново. Для этого промежуточные данные сохраняются в sessionStorage или в БД (для авторизованных):

// Zustand + persist middleware
const useCheckoutStore = create<CheckoutState>()(
  persist(
    (set) => ({
      step: 1,
      contact: {},
      address: {},
      shipping: null,
      payment: null,
      setStep: (step) => set({ step }),
      setContact: (contact) => set({ contact }),
    }),
    { name: 'checkout-draft', storage: createJSONStorage(() => sessionStorage) }
  )
);

Валидация на клиенте и сервере

Валидация выполняется на обоих уровнях. На клиенте — React Hook Form + Zod для мгновенной обратной связи. На сервере — повторная проверка перед созданием заказа.

Пример схемы контактных данных:

const contactSchema = z.object({
  email: z.string().email('Некорректный email'),
  phone: z.string().regex(/^\+7\d{10}$/, 'Введите номер в формате +7XXXXXXXXXX'),
  first_name: z.string().min(2, 'Минимум 2 символа').max(50),
  last_name: z.string().min(2).max(50),
});

Серверная валидация использует те же правила, но дополнительно проверяет: наличие товаров на складе, актуальность цен, корректность промокода.

Создание заказа — атомарная транзакция

Создание заказа должно быть атомарным. В рамках одной транзакции:

DB::transaction(function () use ($checkoutData) {
    $order = Order::create([...]);
    foreach ($checkoutData['items'] as $item) {
        $product = Product::lockForUpdate()->find($item['product_id']);
        if ($product->stock < $item['quantity']) {
            throw new InsufficientStockException($product->name);
        }
        $product->decrement('stock', $item['quantity']);
        $order->items()->create([...]);
    }
    $order->applyDiscount($checkoutData['coupon'] ?? null);
    event(new OrderCreated($order));
});

lockForUpdate предотвращает race condition при параллельных заказах одного товара.

Страница подтверждения

После успешного создания заказа — redirect на /orders/{id}/confirmation. На этой странице:

• Номер заказа и краткое резюме
• Инструкции по оплате (если выбрана оплата по счёту)
• Ожидаемые сроки доставки
• Ссылка на отслеживание статуса

Email с подтверждением уходит через очередь (Laravel Queue + Redis), не в момент ответа на запрос.

Безопасность и предотвращение дублирования

Форма checkout защищается от двойного сабмита через idempotency_key — уникальный UUID, генерируемый при открытии страницы и отправляемый с каждым запросом. Сервер проверяет ключ в Redis: если заказ с таким ключом уже создан, возвращает существующий заказ без повторного создания.

CSRF-токен обязателен для всех POST-запросов. Для платёжных данных — отдельный уровень шифрования или полный вынос в iframe платёжного провайдера (PCI DSS scope reduction).

Аналитика воронки

Каждый шаг checkout отправляет событие в GA4: begin_checkout, add_shipping_info, add_payment_info, purchase. Это позволяет строить воронку и видеть точку отказа.

Средний показатель: если checkout многошаговый, ожидаемый drop на каждом шаге — 10–20%. Если drop на первом шаге превышает 40% — проблема с UX или скоростью загрузки.