Документація · Шлюзи · INT
Stripe Checkout Міжнародний
Картки, Apple/Google Pay, BLIK/P24/Klarna (через Stripe). Офіційна документація: https://docs.stripe.com/api/checkout/sessions. Комісія шлюзу: за тарифом Stripe країни акаунта.
Доступи
sk_live_… та секрет вебхука whsec_…. Stripe не доступний для українських ФОП/ТОВ — акаунт відкривається на компанію з підтримуваної країни (Естонія, Польща, США/Atlas тощо).
- Змінні середовища
STRIPE_SECRET_KEYSTRIPE_WEBHOOK_SECRETSTRIPE_PAYMENT_METHODS (опц.)- Вебхук
POST /webhooks/stripe;Stripe-Signature: t=…,v1=…, v1 = HMAC-SHA256(`t.тіло`, whsec); допуск 5 хв проти replay.
Що викликає Місток
| Запит | Поля / сенс |
|---|---|
POST /v1/checkout/sessions | mode=payment, line_items[], success_url/cancel_url, client_reference_id, customer_email, metadata, expires_at, capture_method=manual для hold; Idempotency-Key |
GET /v1/checkout/sessions/{id}?expand[]=payment_intent | статус |
POST /v1/refunds | payment_intent, amount |
POST /v1/payment_intents/{id}/capture · POST /v1/checkout/sessions/{id}/expire | списання холду · анулювання |
Статуси
session.expired → expired · payment_status=paid → success (refunded → reversed) · requires_capture → hold · canceled → failure.
Модель Містка: created → processing → (hold →) success | failure | expired | reversed. Замовлення в Shopify отримує оплату лише на success і лише після звірки суми й валюти з нашим записом.
Пісочниця
Тестові ключі sk_test_… та тестові картки Stripe.
Обмеження
- підключайте для покупців поза Україною (Markets); для PL дешевше P24/PayU напряму
Перевірено проти офіційної документації, відкритих питань немає.