Conectarea Stripe

Acceptarea plăților online prin Stripe: carduri, Apple Pay, Google Pay.

1. Prezentare generală#

Stripe — o platformă globală de plăți. În registrul Cenaly, Stripe este disponibil pentru conectare în 46 de țări. Integrarea Cenaly + Stripe vă permite să:

• 💳 Acceptați plăți cu carduri (Visa, Mastercard, AmEx)
• 📱 Apple Pay / Google Pay — plată cu o singură atingere
• 💰 Primiți plăți în contul dumneavoastră bancar
• 🔄 Procesați rambursări din panoul de administrare
• 💵 Bacșiș — clientul adaugă bacșiș la plată
• 📊 Rapoarte — analiză financiară completă

2. Cerințe#

• ✅ Cont Cenaly (plata online este disponibilă pe orice plan, inclusiv cel gratuit)
• ✅ Cont Stripe (înregistrare gratuită pe stripe.com)
• ✅ Cont bancar pentru plăți (în valuta țării dumneavoastră)
• ✅ Documente pentru verificare (pașaport / ID, documente ale companiei)

Țări acceptate#

Stripe este oferit pentru conectare în 46 de țări:

3. Crearea unui cont Stripe#

Pasul 1. Înregistrarea#

1. Accesați stripe.com → Start now
2. Indicați emailul și creați o parolă
3. Confirmați emailul

Pasul 2. Verificarea afacerii#

Stripe va solicita:

Verificarea durează de obicei 1–3 zile lucrătoare.

Pasul 3. Obțineți cheile API#

1. În dashboardul Stripe: Developers → API keys
2. Copiați:
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

4. Conectarea la Cenaly#

Se conectează propriul dumneavoastră cont Stripe: banii clientului merg direct în soldul dumneavoastră Stripe, Cenaly nu îi deține.

Deschideți Magazinul de aplicații → categoria „Finanțe” → cardul Stripe → „Configurare” — blocul de conectare se va deschide într-o fereastră modală direct în magazin. Și traseul obișnuit funcționează: Puncte de lucru → cardul punctului de lucru → fila „Plăți” (secțiunea „Plata de către client”), butonul „Conectare” de lângă cardul Stripe.

Asistentul de conectare (recomandat)#

Asistentul pas cu pas (≈10 minute) vă ghidează prin întregul proces, arătând unde să faceți clic în dashboardul Stripe:

1. Alegeți modul — de test sau de producție. Modul din Stripe și comutatorul „Test / Producție” din Cenaly trebuie să coincidă.
2. Copiați cheile — Developers → API keys: Secret key (sk_test_… / sk_live_…) este obligatorie, Publishable key (pk_…) — opțională.
3. Adăugați webhook-ul — Developers → Webhooks → Add endpoint, iar în câmpul Endpoint URL lipiți adresa webhook-ului Cenaly, pe care asistentul o oferă prin butonul „Copiază”. Fără webhook, Stripe nu va anunța că comanda a fost plătită, iar comanda poate rămâne în statusul „în așteptare”.
4. Selectați evenimentele — în blocul „Select events” adăugați obligatoriu checkout.session.completed (tocmai acesta confirmă plata comenzii), iar pentru metodele de plată amânate — și checkout.session.async_payment_succeeded și checkout.session.async_payment_failed. Apoi apăsați „Add endpoint”. Fără aceste evenimente, webhook-ul este creat, dar nu va anunța despre plată.
5. Copiați Webhook signing secret (whsec_…) — câmp opțional, dar cu el se activează verificarea semnăturii notificărilor.
6. Conectați — valorile introduse ajung pe un backend securizat.

Formularul scurt#

Dacă știți deja unde se află fiecare lucru în Stripe, deschideți formularul de conectare inline și completați aceleași câmpuri: Secret key, Webhook signing secret (opț.), Publishable key (opț.) plus comutatorul de mod.

5. Configurarea metodelor de plată#

Carduri bancare#

Activate automat la conectarea Stripe:

• Visa / Mastercard — toate țările
• American Express — majoritatea țărilor
• Diners Club / Discover — selectiv

Apple Pay și Google Pay#

Nu există comutatoare separate în Cenaly pentru acestea: plata se face pe pagina găzduită Stripe Checkout, prin urmare portofelele se activează din partea Stripe.

• Google Pay — funcționează imediat după conectarea Stripe (Android, Chrome).
• Apple Pay — Stripe solicită confirmarea domeniului: Settings → Payment methods → Apple Pay → Add new domain. După verificare, butonul va apărea pe iOS/Safari.

Alte metode#

Prin Stripe Dashboard puteți activa:

Activați metodele dorite în Stripe Dashboard → Settings → Payment methods.

6. Bacșișuri#

Configurare#

1. Locații → cardul locației → fila „General” → comutatorul „Bacșișuri”.
2. Cum funcționează:

Cum vede clientul#

La plată, după selectarea preparatelor:

Comanda dvs.: 45₾

Adăugați bacșiș?
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ Altă sumă ]
[ Fără bacșiș ]

TOTAL: 49.50₾   [Plătiți →]

Rapoarte de bacșișuri#

Secțiunea Finanțe:

• fila „Prezentare generală” — suma totală a bacșișurilor pentru perioadă, cu comparație față de perioada anterioară;
• fila „Vânzări” — bacșișurile defalcate pe ospătari.

7. Plăți în contul dvs.#

Cum virează Stripe banii#

Clientul plătește → Stripe reține → După T+2 zile → Banii în contul dvs.

Configurarea programului#

În Stripe Dashboard → Settings → Payouts:

• Zilnic (recomandat)
• Săptămânal (o anumită zi a săptămânii)
• Lunar

8. Comisioane Stripe#

9. Rambursări#

Rambursarea banilor prin Stripe se inițiază din două locuri — în funcție de modul în care a fost deservită comanda.

Rambursări pentru magazin online (RMA)#

1. Secțiunea Rambursări → cardul cererii.
2. Alegeți modul de rambursare: pe metoda de plată inițială (Stripe), cu card cadou (store credit) sau prin schimb.
3. Bifați articolele (rambursare totală sau parțială) și decideți dacă produsul se returnează în depozit.
4. Banii pleacă direct din pagină; pe cardul clientului ajung de obicei în 5–10 zile lucrătoare.

Rambursări la casă#

În POS rambursarea se face pe baza chitanței — totală sau parțială, există și schimb cu revânzare. Schimbul de numerar trebuie să fie deschis.

În cardul comenzii din secțiunea Comenzi sunt vizibile etichetele rambursărilor efectuate, cu link către cerere.

10. Securitate#

PCI DSS#

• Cenaly nu stochează datele cardurilor — totul este procesat de Stripe
• Stripe este certificat ca PCI Level 1 (nivelul cel mai înalt)
• Datele cardurilor sunt criptate și tokenizate

3D Secure#

• Verificare automată 3D Secure pentru cardurile EU (SCA/PSD2)
• Reduce frauda și chargeback-urile
• Pentru client: confirmare în aplicația băncii

Radar (protecție împotriva fraudei)#

Stripe Radar blochează automat tranzacțiile suspecte:

• Tipar neobișnuit de achiziții
• Carduri de pe liste negre
• Anomalii de geolocalizare

11. Testare#

Înainte de activarea în producție, testați:

Carduri de test Stripe#

CVV: orice 3 cifre. Data: orice dată viitoare. ZIP: orice.

Cum se testează#

1. La conectare, alegeți comutatorul „Mod de test” (fiecare furnizor are propriul comutator).
2. Folosiți cheile de test (pk_test_..., sk_test_...) — și webhook-ul creat în același mod de test Stripe.
3. Faceți o comandă de test → plătiți cu un card de test.
4. Verificați starea comenzii în secțiunea Comenzi — ar trebui să devină „Plătită”.
5. Când totul funcționează — reconectați furnizorul cu cheile reale în modul „Live”.

12. Furnizori alternativi#

Pentru țările fără Stripe sau ca completare — deja pregătiți pentru conectare:

Încă 94 de furnizori (Adyen, PayTR, ЮKassa, LiqPay, Mercado Pago, Razorpay și alții) sunt deja în listă, dar sunt afișați cu gri — integrarea este încă în testare. Prezentare completă — în secțiunea Plată.

Conectarea oricărui furnizor: Magazin de aplicații → categoria „Finanțe” → cardul furnizorului → „Configurează”, fie pe calea obișnuită Locații → cardul locației → fila „Plăți”.

13. Întrebări frecvente#

Când voi primi banii?#

În 2 zile lucrătoare după plată (T+2). Prima plată poate dura 7–14 zile (până când Stripe verifică contul).

Oaspetele vrea să plătească în numerar — cum procedăm?#

Metodele „numerar” și „card la livrare” sunt disponibile întotdeauna și nu necesită un furnizor de plăți — oaspetele le alege la finalizarea comenzii, iar decontarea o face casierul. Stripe nu este implicat în acest caz; bonul este emis la casă, dacă aveți conectat hardware fiscal (vezi Fiscalizare).

Pot conecta atât Stripe, cât și BOG iPay?#

Da. În fila „Plăți” puteți activa mai mulți furnizori simultan — la finalizarea comenzii, oaspetele va vedea câte un buton pentru fiecare, etichetat cu numele furnizorului.

Stripe a blocat contul — ce să fac?#

1. Verificați emailul — Stripe trimite motivul
2. De obicei este necesară o verificare suplimentară
3. Contactați Stripe Support: support.stripe.com
4. Pe durata blocării puteți folosi un furnizor alternativ

Cum să minimizez comisionul?#

• Încurajați plata cu carduri EU (1,5% în loc de 2,9%)
• Folosiți SEPA pentru sume mari (0,35€ fix)
• La un volum mare (>100K€/lună) — solicitați de la Stripe un plan individual

14. Suport#

• Stripe: support.stripe.com
• Cenaly: support@cenaly.com → subiectul „Stripe / Plată”
• Stripe Status: status.stripe.com (verificarea funcționării)