Головна/Блог/Безпека платежів
Безпека платежівОпубліковано · Оновлено ⚡ 15 хв читання

Stripe і PCI-DSS 4.0: платіжний флоу в Next.js, який справді проходить аудити

Слухайте, пройти PCI-DSS 4.0 у Next.js зі Stripe — це величезний головний біль. Ось як саме ми відправили це в прод, не вбивши конверсію.

VG
Vladyslav Gusarov
DevSecOps Lead у Bryxe
Stripe і PCI-DSS 4.0: як збудувати непробивний платіжний флоу в Next.js [гайд 2026]

PCI-DSS 4.0 вийшов. Він змінює все. Більше не вийде просто вставити на сторінку iframe Stripe Elements і вважати справу зробленою. Аудитори всерйоз узялися за безпеку фронтенду, а це означає, що під капотом уся ваша Next.js-архітектура має враховувати безперервний моніторинг і принципи zero trust, які, чесно кажучи, здаються надмірними — доки не побачите структуру штрафів.

Справа ось у чому: ми будуємо платіжний флоу. Ми використовуємо Next.js і Stripe. Він має бути герметичним. Я покажу вам точне налаштування CSP, математику підписів вебхуків і приховані пастки, на яких спотикається більшість команд.

Чому PCI-DSS 4.0 — біль для Next.js-розробників

Прочитайте специфікацію. Вона сувора. З березня 2024 року все це обовʼязкове. І якщо не стежити, воно напряму ламає ваш стандартний фронтенд-деплой.

  1. Requirement 6.4.3: керування всіма скриптами платіжної сторінки, що завантажуються й виконуються в браузері споживача.
  2. Requirement 11.6.1: механізми виявлення несанкціонованих змін на платіжних сторінках.
  3. Targeted Risk Analysis (TRA): перехід від періодичного до безперервного моніторингу відповідності.

Фінансові наслідки зламів платежів

Злами дорогі. Штрафи вас збанкрутують. Просто подивіться на сирі цифри, коли доводитимете, чому цей спринт треба витратити на безпеку, а не на чергову криву продуктову фічу.

Ось гірка правда. Якщо платформа, що обробляє 10,000 транзакцій на місяць, зазнає зламу з розкриттям 5,000 записів: * Безпосередня вартість витоку даних: $825,000 * Штрафи PCI (оцінка за 3 місяці): $150,000 * Загальний початковий збиток: $975,000

Витратьте гроші зараз. Виправте devops-пайплайн. Ви не хочете пояснювати раді директорів, чому пропустили це.

Зʼєднуємо Next.js і Stripe

Ми використовуємо Stripe Elements. Це стандарт. Stripe забирає на себе сирі дані PAN, тож наші бази даних їх ніколи не бачать, — і лише тому ми залишаємося поза Scope A. Але знаєте що? Ми все одно віддаємо iframe, і це закидає нас просто на територію SAQ A, де треба довести, що наш хост-застосунок не скомпрометований повністю.

1. Посилення Content Security Policy (CSP)

Requirement 6.4.3 — величезна пастка. Вам потрібен абсолютний контроль над кожним скриптом на платіжній сторінці. Next.js middleware — буквально єдине розумне місце, щоб динамічно вставляти ці CSP-заголовки так, щоб вони справді працювали й не спричиняли масштабного блокування рендерингу в edge-функціях Vercel.

typescriptВихідний код
// middleware.ts
import { NextResponse } from 'next/server'
import type { NextRequest } from 'next/server'

export function middleware(request: NextRequest) {
  const nonce = Buffer.from(crypto.randomUUID()).toString('base64')
  
  // Strict CSP for Stripe Integration
  const cspHeader = `
    default-src 'self';
    script-src 'self' 'nonce-${nonce}' https://js.stripe.com;
    connect-src 'self' https://api.stripe.com;
    frame-src 'self' https://js.stripe.com https://hooks.stripe.com;
    style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;
    font-src 'self' https://fonts.gstatic.com;
    img-src 'self' data: https://*.stripe.com;
    object-src 'none';
    base-uri 'self';
    form-action 'self';
    frame-ancestors 'none';
    upgrade-insecure-requests;
  `
  
  const contentSecurityPolicyHeaderValue = cspHeader
    .replace(/\s{2,}/g, ' ')
    .trim()

  const requestHeaders = new Headers(request.headers)
  requestHeaders.set('x-nonce', nonce)
  requestHeaders.set(
    'Content-Security-Policy',
    contentSecurityPolicyHeaderValue
  )

  const response = NextResponse.next({
    request: {
      headers: requestHeaders,
    },
  })

  response.headers.set(
    'Content-Security-Policy',
    contentSecurityPolicyHeaderValue
  )
  
  // HSTS implementation for secure transport
  response.headers.set(
    'Strict-Transport-Security',
    'max-age=31536000; includeSubDomains; preload'
  )

  return response
}

Ось гірка правда. Жорстка CSP наповал убиває Magecart. Жодне випадкове стороннє сміття тут не виконається.

2. Безпечне створення Intent (бекенд)

Не довіряйте клієнту. Ніколи. Якщо ви рахуєте ціни в браузері, хтось змінить пейлоад і купить ваш преміум-тариф за копійку. Логіка PaymentIntent має жити глибоко в серверному маршруті, який отримує справжню ціну безпосередньо з вашої бази даних, перш ніж узагалі звертатися до Stripe API.

typescriptВихідний код
// app/api/create-payment-intent/route.ts
import { NextResponse } from 'next/server';
import Stripe from 'stripe';
import { db } from '@/lib/db';
import { rateLimit } from '@/lib/rate-limit';
import { headers } from 'next/headers';

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!, {
  apiVersion: '2023-10-16',
});

export async function POST(req: Request) {
  try {
    // 1. Rate Limiting (DDoS mitigation)
    const ip = headers().get('x-forwarded-for') ?? '127.0.0.1';
    const { success } = await rateLimit.limit(ip);
    if (!success) {
      return NextResponse.json({ error: 'Too many requests' }, { status: 429 });
    }

    const body = await req.json();
    const { productId, customerId } = body;

    // 2. Trust No Client Data - Fetch pricing securely
    const product = await db.product.findUnique({ where: { id: productId } });
    
    if (!product) {
      return NextResponse.json({ error: 'Product not found' }, { status: 404 });
    }

    // 3. Create Intent with strict metadata for reconciliation
    const paymentIntent = await stripe.paymentIntents.create({
      amount: product.priceInCents,
      currency: 'usd',
      customer: customerId,
      automatic_payment_methods: {
        enabled: true,
      },
      metadata: {
        productId: product.id,
        internalTransactionId: crypto.randomUUID(),
      },
    });

    return NextResponse.json({
      clientSecret: paymentIntent.client_secret,
    });
  } catch (error) {
    console.error('PaymentIntent creation failed:', error);
    return NextResponse.json(
      { error: 'Internal server error' },
      { status: 500 }
    );
  }
}

3. Реалізація клієнтського інтерфейсу

Відрендерте форму. Тримайте все просто. Ми підключаємо @stripe/react-stripe-js і монтуємо елемент.

tsxВихідний код
// components/CheckoutForm.tsx
'use client';

import {
  PaymentElement,
  useStripe,
  useElements,
} from '@stripe/react-stripe-js';
import { useState } from 'react';

export default function CheckoutForm() {
  const stripe = useStripe();
  const elements = useElements();
  const [errorMessage, setErrorMessage] = useState<string | null>(null);
  const [isProcessing, setIsProcessing] = useState(false);

  const handleSubmit = async (event: React.FormEvent) => {
    event.preventDefault();

    if (!stripe || !elements) {
      return;
    }

    setIsProcessing(true);

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

    if (error) {
      setErrorMessage(error.message ?? 'An unknown error occurred');
    }
    
    setIsProcessing(false);
  };

  return (
    <form onSubmit={handleSubmit} className="space-y-6 max-w-md mx-auto">
      <PaymentElement 
        options={{
          layout: 'tabs',
        }} 
      />
      <button 
        disabled={!stripe || isProcessing}
        className="w-full bg-blue-600 text-white py-3 px-4 rounded-md hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2 disabled:opacity-50 transition-colors"
      >
        {isProcessing ? 'Processing...' : 'Pay Now'}
      </button>
      {errorMessage && (
        <div className="text-red-500 text-sm mt-2 font-medium" role="alert">
          {errorMessage}
        </div>
      )}
    </form>
  );
}

Захист приймача вебхуків

Вебхуки — це абсолютна пастка. Якщо ви не перевіряєте підписи належним чином, буквально будь-хто може зробити curl на ваш ендпоінт і позначити рахунки як оплачені.

Чекліст вимог до безпеки вебхуків

ВимогаДеталі реалізаціїВід чого захищає
Перевірка підписуКриптографічна перевірка заголовка Stripe-SignatureАтаки підробки (spoofing)
ІдемпотентністьОбробка подій рівно один раз за ID подій StripeReplay-атаки / стани гонитви
Захист від повторівПеревірка мітки часу в підписі (за замовчуванням допуск 5 min)Відкладені replay-атаки
Цілісність пейлоадуВикористання буфера сирого тіла запиту для обчислення підписуМодифікація через man-in-the-middle

Непробивний маршрут для вебхуків

Мені набридло бачити це в PR. Next.js App Router намагається автоматично розпарсити JSON за вас. Знищіть це. Вам потрібен буфер сирого тіла, щоб виконати криптографічну перевірку підпису з ключем Stripe, інакше хеші ніколи не збігатимуться, і ви витратите три дні на дебаг.

typescriptВихідний код
// app/api/webhooks/stripe/route.ts
import { NextResponse } from 'next/server';
import Stripe from 'stripe';
import { headers } from 'next/headers';
import { db } from '@/lib/db';

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!, {
  apiVersion: '2023-10-16',
});

const endpointSecret = process.env.STRIPE_WEBHOOK_SECRET!;

export async function POST(req: Request) {
  const body = await req.text();
  const sig = headers().get('stripe-signature') as string;

  let event: Stripe.Event;

  try {
    // Cryptographic verification of payload integrity
    event = stripe.webhooks.constructEvent(body, sig, endpointSecret);
  } catch (err: any) {
    console.error(`Webhook signature verification failed: ${err.message}`);
    return NextResponse.json({ error: 'Webhook Error' }, { status: 400 });
  }

  // Idempotency check: Have we processed this event?
  const existingEvent = await db.processedEvent.findUnique({
    where: { id: event.id },
  });

  if (existingEvent) {
    console.log(`Event ${event.id} already processed. Skipping.`);
    return NextResponse.json({ received: true });
  }

  try {
    // Process the event
    switch (event.type) {
      case 'payment_intent.succeeded':
        const paymentIntentSucceeded = event.data.object as Stripe.PaymentIntent;
        await handlePaymentSuccess(paymentIntentSucceeded);
        break;
      case 'payment_intent.payment_failed':
        const paymentIntentFailed = event.data.object as Stripe.PaymentIntent;
        await handlePaymentFailure(paymentIntentFailed);
        break;
      // ... handle other event types
      default:
        console.log(`Unhandled event type ${event.type}`);
    }

    // Record the event as processed for idempotency
    await db.processedEvent.create({
      data: {
        id: event.id,
        type: event.type,
      },
    });

    return NextResponse.json({ received: true });
  } catch (error) {
    console.error('Error processing webhook:', error);
    // Return a 500 to tell Stripe to retry
    return NextResponse.json(
      { error: 'Webhook handler failed' },
      { status: 500 }
    );
  }
}

async function handlePaymentSuccess(intent: Stripe.PaymentIntent) {
  const productId = intent.metadata.productId;
  // Fulfill the order in the database
}

Requirement 11.6.1: виявлення несанкціонованих змін

Вам треба виявляти модифікації на льоту. Тепер це обовʼязково. SRI і CSP покривають базу, але 11.6.1 насправді вимагає активного моніторингу продакшн-DOM, щоб ловити інʼєкції тієї ж секунди, коли вони стаються.

Візьміть Datadog або Sentry. Налаштуйте їх так, щоб вони: 1. Відстежували зміни HTTP-заголовків (зокрема CSP). 2. Сповіщали про несанкціоноване виконання скриптів, заблоковане CSP. 3. Виконували безперервне зовнішнє сканування DOM платіжної сторінки для виявлення вставлених елементів.

Інтеграція в DevSecOps-пайплайн

Автоматизуйте цю рутину. Якщо покладатися на людей у перевірці безпекових заголовків, усе зламається.

Pre-commit хуки

Будьмо чесні. Перестаньте комітити API-ключі. Налаштуйте trufflehog або git-secrets локально, поки хтось не запушив бойовий ключ Stripe у публічний репозиторій і не зіпсував вам вихідні.

bashВихідний код
# Install git-secrets
git secrets --install
git secrets --add 'sk_(test|live)_[0-9a-zA-Z]{24,99}'
git secrets --add 'rk_(test|live)_[0-9a-zA-Z]{24,99}'

SAST (Static Application Security Testing)

Додайте Semgrep у свої GitHub Actions. Нехай він кричить на розробників, коли вони забувають перевірити підпис вебхука.

yamlВихідний код
# .github/workflows/semgrep.yml
name: Semgrep
on: [push, pull_request]
jobs:
  semgrep:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: returntocorp/semgrep-action@v1
        with:
          config: p/javascript
          generateCodeScanningAlerts: true

Підсумок

Запустити Stripe у Next.js легко. Пройти аудит PCI-DSS 4.0 важко. Вам треба жорстко обмежити CSP, забезпечити ідемпотентність, щоб вебхуки не списували з клієнтів гроші двічі, і перенести всі справжні розрахунки на бекенд, куди зловмисники не дотягнуться.

Ми не просто ставимо галочки для комплаєнсу. Ми будуємо системи, через які нас не будитимуть о 3 AM, коли хтось спробує запустити Magecart-скрипт проти наших сторінок оплати.

АВТОМАТИЗОВАНИЙ ЗАХИСТ

Не чекайте на експлойт, щоб перевірити кодову базу

Перегляньте підтримувані ризики в коді, відкриті секрети й знахідки в залежностях із Bryxe Shield. Перевірте виправлення у своєму застосунку перед релізом.

Потрібен практичний наступний крок? Перегляньте практичні посібники з безпеки або прочитайте нашу редакційну політику та політику щодо джерел.

Рекомендовані дослідження безпеки