Підключення Stripe

Приймання онлайн-платежів через Stripe: картки, Apple Pay, Google Pay.

1. Огляд#

Stripe — глобальна платіжна платформа. У реєстрі Cenaly Stripe доступний до підключення в 46 країнах. Інтеграції Cenaly + Stripe дають змогу:

• 💳 Приймати оплату картками (Visa, Mastercard, AmEx)
• 📱 Apple Pay / Google Pay — оплата в один дотик
• 💰 Отримувати виплати на ваш банківський рахунок
• 🔄 Обробляти повернення з адмін-панелі
• 💵 Чайові — гість додає чайові під час оплати
• 📊 Звіти — повна фінансова аналітика

2. Вимоги#

• ✅ Обліковий запис Cenaly (онлайн-оплата доступна на будь-якому плані, включно з безкоштовним)
• ✅ Обліковий запис Stripe (безкоштовна реєстрація на stripe.com)
• ✅ Банківський рахунок для виплат (у валюті вашої країни)
• ✅ Документи для верифікації (паспорт / ID, документи компанії)

Підтримувані країни#

Stripe пропонується до підключення в 46 країнах:

3. Створення облікового запису Stripe#

Крок 1. Реєстрація#

1. Перейдіть на stripe.com → Start now
2. Вкажіть email і створіть пароль
3. Підтвердьте email

Крок 2. Верифікація бізнесу#

Stripe запросить:

Верифікація зазвичай триває 1–3 робочих дні.

Крок 3. Отримайте API-ключі#

1. У дашборді Stripe: Developers → API keys
2. Скопіюйте:
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

4. Підключення до Cenaly#

Підключається ваш власний обліковий запис Stripe: гроші гостя йдуть напряму на ваш баланс Stripe, Cenaly їх не тримає.

Відкрийте Магазин додатків → категорія «Фінанси» → картка Stripe → «Налаштувати» — блок підключення відкриється модальним вікном прямо в магазині. Звичний шлях теж працює: Точки → картка точки → вкладка «Оплати» (секція «Оплата гостем»), кнопка «Підключити» біля картки Stripe.

Майстер підключення (рекомендовано)#

Покроковий майстер (≈10 хвилин) проводить через увесь процес, показуючи, куди натискати в дашборді Stripe:

1. Виберіть режим — тестовий або бойовий. Режим у Stripe і перемикач «Тестовий / Бойовий» у Cenaly мають збігатися.
2. Скопіюйте ключі — Developers → API keys: Secret key (sk_test_… / sk_live_…) обов'язковий, Publishable key (pk_…) — за бажанням.
3. Додайте вебхук — Developers → Webhooks → Add endpoint, а в поле Endpoint URL вставте адресу вебхука Cenaly, яку майстер дає кнопкою «Копіювати». Без вебхука Stripe не повідомить, що замовлення оплачено, і замовлення може залишитися в статусі «очікує».
4. Виберіть події — у блоці «Select events» обов'язково додайте checkout.session.completed (саме воно підтверджує оплату замовлення), а для відкладених способів оплати — ще checkout.session.async_payment_succeeded і checkout.session.async_payment_failed. Потім натисніть «Add endpoint». Без цих подій вебхук створено, але про оплату він не повідомить.
5. Скопіюйте Webhook signing secret (whsec_…) — необов'язкове поле, але з ним вмикається перевірка підпису повідомлень.
6. Підключити — введені значення надходять на захищений бекенд.

Коротка форма#

Якщо ви вже знаєте, де що лежить у Stripe, відкрийте інлайн-форму підключення та заповніть ті самі поля: Secret key, Webhook signing secret (опц.), Publishable key (опц.) плюс перемикач режиму.

5. Налаштування способів оплати#

Банківські картки#

Автоматично ввімкнені під час підключення Stripe:

• Visa / Mastercard — усі країни
• American Express — більшість країн
• Diners Club / Discover — вибірково

Apple Pay і Google Pay#

Окремих перемикачів у Cenaly для них немає: оплата відбувається на hosted-сторінці Stripe Checkout, тому гаманці вмикаються на боці Stripe.

• Google Pay — працює одразу після підключення Stripe (Android, Chrome).
• Apple Pay — Stripe вимагає підтвердити домен: Settings → Payment methods → Apple Pay → Add new domain. Після верифікації кнопка з'явиться на iOS/Safari.

Інші методи#

Через Stripe Dashboard можна ввімкнути:

Увімкніть потрібні методи в Stripe Dashboard → Settings → Payment methods.

6. Чайові#

Налаштування#

1. Локації → картка локації → вкладка «Загальне» → перемикач «Чайові».
2. Як це працює:

Як це бачить гість#

Під час оплати після вибору страв:

Ваше замовлення: 45₾

Додати чайові?
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ Інша сума ]
[ Без чайових ]

РАЗОМ: 49.50₾   [Оплатити →]

Звіти з чайових#

Розділ Фінанси:

• вкладка «Огляд» — загальна сума чайових за період із порівнянням із попереднім;
• вкладка «Продажі» — чайові в розрізі офіціантів.

7. Виплати на ваш рахунок#

Як Stripe виплачує гроші#

Гість оплачує → Stripe утримує → Через T+2 дні → Гроші на вашому рахунку

Налаштування розкладу#

У Stripe Dashboard → Settings → Payouts:

• Щоденно (рекомендовано)
• Щотижня (конкретний день тижня)
• Щомісяця

8. Комісії Stripe#

9. Повернення#

Повернення грошей через Stripe запускається з двох місць — залежно від того, як обслуговувалося замовлення.

Повернення інтернет-магазину (RMA)#

1. Розділ Повернення → картка заявки.
2. Виберіть режим повернення: на початковий спосіб оплати (Stripe), подарунковою карткою (store credit) або обміном.
3. Позначте товари (повне або часткове повернення) і вирішіть, чи повертати товар на склад.
4. Гроші йдуть прямо зі сторінки; на картку гостя вони надходять зазвичай за 5–10 робочих днів.

Повернення на касі#

У POS повернення оформлюється за чеком — повне або часткове, є й обмін із перепродажем. Касова зміна при цьому має бути відкрита.

У картці замовлення в розділі Замовлення видно бейджі оформлених повернень із посиланням на заявку.

10. Безпека#

PCI DSS#

• Cenaly не зберігає дані карток — усе обробляє Stripe
• Stripe сертифіковано як PCI Level 1 (найвищий рівень)
• Дані карток шифруються й токенізуються

3D Secure#

• Автоматична перевірка 3D Secure для карток EU (SCA/PSD2)
• Знижує шахрайство та чарджбеки
• Для гостя: підтвердження в додатку банку

Radar (захист від шахрайства)#

Stripe Radar автоматично блокує підозрілі транзакції:

• Незвичний патерн покупок
• Картки з чорних списків
• Геолокаційні аномалії

11. Тестування#

Перед увімкненням у продакшн протестуйте:

Тестові картки Stripe#

CVV: будь-які 3 цифри. Дата: будь-яка майбутня. ZIP: будь-який.

Як тестувати#

1. Під час підключення виберіть перемикач «Тестовий режим» (він у кожного провайдера свій).
2. Використовуйте тестові ключі (pk_test_..., sk_test_...) — і вебхук, створений у тому самому тестовому режимі Stripe.
3. Зробіть тестове замовлення → оплатіть тестовою карткою.
4. Перевірте статус замовлення в розділі Замовлення — має стати «Оплачено».
5. Коли все працює — перепідключіть провайдера з бойовими ключами в режимі «Бойовий».

12. Альтернативні провайдери#

Для країн без Stripe або як доповнення — уже готові до підключення:

Ще 94 провайдери (Adyen, PayTR, ЮKassa, LiqPay, Mercado Pago, Razorpay та ін.) уже є у списку, але відображаються сірим — інтеграція ще тестується. Повний огляд — у розділі Оплата.

Підключення будь-якого провайдера: Магазин додатків → категорія «Фінанси» → картка провайдера → «Налаштувати», або звичним шляхом Точки → картка точки → вкладка «Оплати».

13. Часті запитання#

Коли я отримаю гроші?#

Через 2 робочі дні після оплати (T+2). Перша виплата може зайняти 7–14 днів (поки Stripe верифікує обліковий запис).

Гість хоче оплатити готівкою — як бути?#

Способи «готівкою» та «карткою при отриманні» доступні завжди й не потребують платіжного провайдера — гість обирає їх на чекауті, а розрахунок проводить касир. Stripe при цьому не задіюється; чек пробивається на касі, якщо у вас підключено фіскальне обладнання (див. Фіскалізація).

Чи можна підключити і Stripe, і BOG iPay?#

Так. На вкладці «Оплати» можна увімкнути кілька провайдерів одразу — на чекауті гість побачить по кнопці на кожного, підписаній іменем провайдера.

Stripe заблокував обліковий запис — що робити?#

1. Перевірте email — Stripe надсилає причину
2. Зазвичай потрібна додаткова верифікація
3. Зверніться до Stripe Support: support.stripe.com
4. На час блокування можна використати альтернативний провайдер

Як мінімізувати комісію?#

• Заохочуйте оплату картками EU (1.5% замість 2.9%)
• Використовуйте SEPA для великих сум (0.35€ фікс)
• При великому обороті (>100K€/міс) — запросіть у Stripe індивідуальний тариф

14. Підтримка#

• Stripe: support.stripe.com
• Cenaly: support@cenaly.com → тема «Stripe / Оплата»
• Stripe Status: status.stripe.com (перевірка працездатності)