Povezivanje Stripe

Prihvatanje onlajn plaćanja preko Stripe: kartice, Apple Pay, Google Pay.

1. Pregled#

Stripe — globalna platna platforma. U registru Cenaly Stripe je dostupan za povezivanje u 46 zemalja. Integracije Cenaly + Stripe omogućavaju:

• 💳 Prihvatanje plaćanja karticama (Visa, Mastercard, AmEx)
• 📱 Apple Pay / Google Pay — plaćanje jednim dodirom
• 💰 Primanje isplata na vaš bankovni račun
• 🔄 Obrada povraćaja iz admin panela
• 💵 Bakšiš — gost dodaje bakšiš pri plaćanju
• 📊 Izveštaji — potpuna finansijska analitika

2. Zahtevi#

• ✅ Nalog Cenaly (onlajn plaćanje je dostupno na svakom planu, uključujući besplatni)
• ✅ Nalog Stripe (besplatna registracija na stripe.com)
• ✅ Bankovni račun za isplate (u valuti vaše zemlje)
• ✅ Dokumenti za verifikaciju (pasoš / ID, dokumenti kompanije)

Podržane zemlje#

Stripe je predložen za povezivanje u 46 zemalja:

3. Kreiranje naloga Stripe#

Korak 1. Registracija#

1. Idite na stripe.com → Start now
2. Unesite email i kreirajte lozinku
3. Potvrdite email

Korak 2. Verifikacija biznisa#

Stripe će zatražiti:

Verifikacija obično traje 1–3 radna dana.

Korak 3. Preuzmite API ključeve#

1. U Stripe dashboardu: Developers → API keys
2. Kopirajte:
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

4. Povezivanje sa Cenaly#

Povezuje se vaš sopstveni nalog Stripe: novac gosta ide direktno na vaš Stripe balans, Cenaly ga ne zadržava.

Otvorite Prodavnica aplikacija → kategorija „Finansije“ → kartica Stripe → „Podesi“ — blok za povezivanje otvoriće se kao modalni prozor direktno u prodavnici. Uobičajena putanja takođe radi: Lokacije → kartica lokacije → kartica „Plaćanja“ (sekcija „Plaćanje gosta“), dugme „Poveži“ kod kartice Stripe.

Čarobnjak za povezivanje (preporučeno)#

Čarobnjak korak po korak (≈10 minuta) vodi kroz ceo proces, pokazujući gde treba kliknuti u Stripe dashboardu:

1. Izaberite režim — testni ili produkcijski. Režim u Stripe i prekidač „Testni / Produkcijski“ u Cenaly moraju da se poklapaju.
2. Kopirajte ključeve — Developers → API keys: Secret key (sk_test_… / sk_live_…) je obavezan, Publishable key (pk_…) — opciono.
3. Dodajte webhook — Developers → Webhooks → Add endpoint, a u polje Endpoint URL nalepite adresu webhook-a Cenaly koju čarobnjak daje dugmetom „Kopiraj“. Bez webhook-a Stripe neće obavestiti da je porudžbina plaćena, i porudžbina može ostati u statusu „čeka“.
4. Izaberite događaje — u bloku „Select events“ obavezno dodajte checkout.session.completed (upravo ono potvrđuje plaćanje porudžbine), a za odložene načine plaćanja — još checkout.session.async_payment_succeeded i checkout.session.async_payment_failed. Zatim pritisnite „Add endpoint“. Bez ovih događaja webhook je kreiran, ali neće obavestiti o plaćanju.
5. Kopirajte Webhook signing secret (whsec_…) — opciono polje, ali sa njim se uključuje provera potpisa obaveštenja.
6. Poveži — unete vrednosti idu na zaštićeni backend.

Kratka forma#

Ako već znate gde se šta nalazi u Stripe, otvorite inline formu za povezivanje i popunite ista polja: Secret key, Webhook signing secret (opc.), Publishable key (opc.) plus prekidač režima.

5. Podešavanje načina plaćanja#

Bankovne kartice#

Automatski su uključene pri povezivanju sa Stripe:

• Visa / Mastercard — sve zemlje
• American Express — većina zemalja
• Diners Club / Discover — selektivno

Apple Pay i Google Pay#

Za njih ne postoje posebni prekidači u Cenaly: plaćanje se obavlja na hosted stranici Stripe Checkout, pa se novčanici uključuju na strani Stripe.

• Google Pay — radi odmah nakon povezivanja sa Stripe (Android, Chrome).
• Apple Pay — Stripe zahteva potvrdu domena: Settings → Payment methods → Apple Pay → Add new domain. Nakon verifikacije dugme će se pojaviti na iOS/Safari.

Drugi metodi#

Preko Stripe Dashboard možete uključiti:

Uključite potrebne metode u Stripe Dashboard → Settings → Payment methods.

6. Bakšiš#

Podešavanje#

1. Lokacije → kartica lokacije → kartica „Opšte“ → prekidač „Bakšiš“.
2. Kako to funkcioniše:

Kako to vidi gost#

Pri plaćanju nakon izbora jela:

Vaša porudžbina: 45₾

Dodati bakšiš?
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ Drugi iznos ]
[ Bez bakšiša ]

UKUPNO: 49.50₾   [Plati →]

Izveštaji o bakšišu#

Odeljak Finansije:

• kartica „Pregled“ — ukupan iznos bakšiša za period sa poređenjem sa prethodnim;
• kartica „Prodaja“ — bakšiš po konobarima.

7. Isplate na vaš račun#

Kako Stripe isplaćuje novac#

Gost plaća → Stripe zadržava → Nakon T+2 dana → Novac na vašem računu

Podešavanje rasporeda#

U Stripe Dashboard → Settings → Payouts:

• Dnevno (preporučeno)
• Nedeljno (konkretan dan u nedelji)
• Mesečno

8. Stripe provizije#

9. Povraćaji#

Povraćaj novca preko Stripe pokreće se sa dva mesta — u zavisnosti od toga kako je porudžbina opslužena.

Povraćaji internet-prodavnice (RMA)#

1. Odeljak Povraćaji → kartica zahteva.
2. Izaberite režim povraćaja: na prvobitni način plaćanja (Stripe), poklon-karticom (store credit) ili zamenom.
3. Označite stavke (potpun ili delimičan povraćaj) i odlučite da li se roba vraća u magacin.
4. Novac se šalje direktno sa stranice; na karticu gosta obično stiže za 5–10 radnih dana.

Povraćaji na kasi#

U POS-u se povraćaj obrađuje po računu — potpun ili delimičan, postoji i zamena sa ponovnom prodajom. Smena gotovine pri tome mora biti otvorena.

U kartici porudžbine u odeljku Porudžbine vide se bedževi obrađenih povraćaja sa linkom na zahtev.

10. Bezbednost#

PCI DSS#

• Cenaly ne čuva podatke kartica — sve obrađuje Stripe
• Stripe je sertifikovan kao PCI Level 1 (najviši nivo)
• Podaci kartica se šifruju i tokenizuju

3D Secure#

• Automatska provera 3D Secure za kartice EU (SCA/PSD2)
• Smanjuje prevaru i čardžbekove
• Za gosta: potvrda u aplikaciji banke

Radar (zaštita od prevare)#

Stripe Radar automatski blokira sumnjive transakcije:

• Neobičan obrazac kupovine
• Kartice sa crnih lista
• Geolokacijske anomalije

11. Testiranje#

Pre uključivanja u produkciju testirajte:

Stripe test-kartice#

CVV: bilo koje 3 cifre. Datum: bilo koji budući. ZIP: bilo koji.

Kako testirati#

1. Pri povezivanju izaberite prekidač „Testni režim“ (on je kod svakog provajdera svoj).
2. Koristite test-ključeve (pk_test_..., sk_test_...) — i vebhuk kreiran u istom testnom režimu Stripe.
3. Napravite testnu porudžbinu → platite test-karticom.
4. Proverite status porudžbine u odeljku Porudžbine — treba da postane „Plaćeno“.
5. Kada sve radi — ponovo povežite provajdera sa produkcionim ključevima u režimu „Produkcija“.

12. Alternativni provajderi#

Za zemlje bez Stripe-a ili kao dodatak — već spremni za povezivanje:

Još 94 provajdera (Adyen, PayTR, ЮKassa, LiqPay, Mercado Pago, Razorpay i dr.) već su na listi, ali se prikazuju sivom bojom — integracija se još testira. Potpun pregled — u odeljku Plaćanje.

Povezivanje bilo kog provajdera: Prodavnica aplikacija → kategorija „Finansije“ → kartica provajdera → „Podesi“, ili uobičajenim putem Lokacije → kartica lokacije → kartica „Plaćanja“.

13. Česta pitanja#

Kada ću dobiti novac?#

Dva radna dana nakon plaćanja (T+2). Prva isplata može potrajati 7–14 dana (dok Stripe verifikuje nalog).

Gost želi da plati gotovinom — kako postupiti?#

Načini „gotovinom“ i „karticom pri preuzimanju“ dostupni su uvek i ne zahtevaju provajdera plaćanja — gost ih bira na kasi, a obračun sprovodi kasir. Stripe se pri tome ne koristi; račun se izdaje na kasi, ako imate povezan fiskalni hardver (vidi Fiskalizacija).

Može li se povezati i Stripe i BOG iPay?#

Da. Na kartici „Plaćanja“ može se uključiti više provajdera odjednom — na kasi će gost videti po jedno dugme za svakog, potpisano imenom provajdera.

Stripe je blokirao nalog — šta raditi?#

1. Proverite email — Stripe šalje razlog
2. Obično je potrebna dodatna verifikacija
3. Obratite se Stripe podršci: support.stripe.com
4. Za vreme blokade možete koristiti alternativnog provajdera

Kako minimizirati proviziju?#

• Podstičite plaćanje EU karticama (1,5% umesto 2,9%)
• Koristite SEPA za velike iznose (0,35€ fiksno)
• Pri velikom prometu (>100K€/mes) — zatražite od Stripe-a individualni plan

14. Podrška#

• Stripe: support.stripe.com
• Cenaly: support@cenaly.com → tema „Stripe / Plaćanje“
• Stripe Status: status.stripe.com (provera rada)