PCI-DSS 4.0 вийшов. Він змінює все. Більше не вийде просто вставити на сторінку iframe Stripe Elements і вважати справу зробленою. Аудитори всерйоз узялися за безпеку фронтенду, а це означає, що під капотом уся ваша Next.js-архітектура має враховувати безперервний моніторинг і принципи zero trust, які, чесно кажучи, здаються надмірними — доки не побачите структуру штрафів.
Справа ось у чому: ми будуємо платіжний флоу. Ми використовуємо Next.js і Stripe. Він має бути герметичним. Я покажу вам точне налаштування CSP, математику підписів вебхуків і приховані пастки, на яких спотикається більшість команд.
Чому PCI-DSS 4.0 — біль для Next.js-розробників
Прочитайте специфікацію. Вона сувора. З березня 2024 року все це обовʼязкове. І якщо не стежити, воно напряму ламає ваш стандартний фронтенд-деплой.
- Requirement 6.4.3: керування всіма скриптами платіжної сторінки, що завантажуються й виконуються в браузері споживача.
- Requirement 11.6.1: механізми виявлення несанкціонованих змін на платіжних сторінках.
- Targeted Risk Analysis (TRA): перехід від періодичного до безперервного моніторингу відповідності.
Фінансові наслідки зламів платежів
Злами дорогі. Штрафи вас збанкрутують. Просто подивіться на сирі цифри, коли доводитимете, чому цей спринт треба витратити на безпеку, а не на чергову криву продуктову фічу.
- Середня вартість одного викраденого запису: $165 (IBM Cost of a Data Breach Report)
- Штрафи за невідповідність PCI: від $5,000 до $100,000 на місяць
- Втрачений дохід: у середньому 3.4% відтоку клієнтів після зламу для SaaS-бізнесів
Ось гірка правда. Якщо платформа, що обробляє 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.
// 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.
// 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 і монтуємо елемент.
// 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 подій Stripe | Replay-атаки / стани гонитви |
| Захист від повторів | Перевірка мітки часу в підписі (за замовчуванням допуск 5 min) | Відкладені replay-атаки |
| Цілісність пейлоаду | Використання буфера сирого тіла запиту для обчислення підпису | Модифікація через man-in-the-middle |
Непробивний маршрут для вебхуків
Мені набридло бачити це в PR. Next.js App Router намагається автоматично розпарсити JSON за вас. Знищіть це. Вам потрібен буфер сирого тіла, щоб виконати криптографічну перевірку підпису з ключем Stripe, інакше хеші ніколи не збігатимуться, і ви витратите три дні на дебаг.
// 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 у публічний репозиторій і не зіпсував вам вихідні.
# 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. Нехай він кричить на розробників, коли вони забувають перевірити підпис вебхука.
# .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-скрипт проти наших сторінок оплати.
![Stripe і PCI-DSS 4.0: як збудувати непробивний платіжний флоу в Next.js [гайд 2026]](/_next/image?url=%2Fblog%2Ftest-mockup.jpg&w=3840&q=75&dpl=dpl_4APdW92RmtTARbNBj4X6xdJXX9hA)