Свързване на 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. Въведете имейл и създайте парола
3. Потвърдете имейла

Стъпка 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. Проверете имейла — Stripe изпраща причината
2. Обикновено се изисква допълнителна верификация
3. Обърнете се към Stripe Support: support.stripe.com
4. По време на блокировката можете да използвате алтернативен доставчик

Как да минимизирам комисионата?#

• Насърчавайте плащане с карти от ЕС (1,5% вместо 2,9%)
• Използвайте SEPA за големи суми (0,35€ фиксирана)
• При голям оборот (>100K€/мес) — поискайте от Stripe индивидуален план

14. Поддръжка#

• Stripe: support.stripe.com
• Cenaly: support@cenaly.com → тема „Stripe / Плащане“
• Stripe Status: status.stripe.com (проверка на работоспособността)