Поврзување на 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. Проверете ја е-поштата — 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 (проверка на работоспособноста)