Stripe integracija v Račun123 (vodič korak za korakom)
Ta vodič te bo v nekaj minutah pripeljal do tega, da se po Stripe plačilu račun samodejno ustvari, davčno potrdi in pošlje stranki.
Po koncu vodiča bo Stripe samodejno pošiljal podatke v Račun123, Račun123 pa bo ustvaril račun brez ročnega dela.
Za večino primerov zadošča ena webhook povezava in dva eventa:
checkout.session.completed in invoice.paid.
1. Odpri Stripe integracijo v Račun123
Pojdi na Nastavitve → Več nastavitev → Integracije → Stripe.
Tukaj vidiš:
- Webhook URL
- Webhook skrivnost (prazno polje)
Produkcijski Webhook URL je:
https://moj.racun123.si/api/integrations/stripe-invoicing
👉 To stran pusti odprto, ker boš podatke potreboval v naslednjih korakih.
2. Dodaj webhook v Stripe
Odpri Stripe Dashboard:
Nato klikni Add endpoint.
Korak 1 (Stripe ekran, ki zmede)
Ko klikneš Add endpoint, Stripe najprej vpraša, za kateri račun želiš prejemati dogodke.
- izberi Your account (levo)
- klikni Continue
Polje za URL se prikaže šele po kliku Continue. Zato ga na prvem ekranu še ne vidiš.
Alternativa: najdi Webhooks preko iskanja
Če v meniju ne najdeš “Developers”, lahko uporabiš iskanje v Stripe:
- v zgornje iskalno polje vpiši: webhooks
- klikni na Webhooks ali Create a webhook
V polje Endpoint URL prilepi:
https://moj.racun123.si/api/integrations/stripe-invoicing
Nato klikni Select events in izberi:
checkout.session.completed invoice.paid
Nato klikni Add endpoint.
checkout.session.completed je pomemben predvsem za enkratna plačila, invoice.paid pa za naročnine, obnove in nadgradnje. Zato priporočamo, da imaš vključena oba.
Če uporabljaš naročnine, je invoice.paid obvezen. Brez njega se računi za obnovitve ali določene nadgradnje ne bodo ustvarjali.
3. Poveži webhook skrivnost
Odpri webhook, ki si ga pravkar ustvaril.
Pri “Signing secret” klikni Reveal.
Kopiraj vrednost, ki se začne z whsec_, in jo prilepi v Račun123 v polje:
Webhook skrivnost
Kako veš, da je webhook pravilno nastavljen?
Ko je webhook pravilno dodan, moraš v Stripe videti:
- status Active
- pravilen Endpoint URL
- izbrana eventa checkout.session.completed in invoice.paid
- viden Signing secret (whsec_…)
👉 Če vidiš to, je webhook pravilno nastavljen.
Pogosta napaka: napačen način (Test / Live)
Stripe ima ločen Test in Live način.
- Webhook mora biti dodan v istem načinu, kot delaš test ali produkcijo
👉 Če testiraš v Test mode, webhook v Live mode ne bo deloval.
4. Hitri povzetek: končna konfiguracija
Kaj nastaviš v Stripe
- Webhook endpoint URL:
https://moj.racun123.si/api/integrations/stripe-invoicing - Obvezna eventa:
- checkout.session.completed
- invoice.paid
Kaj nastaviš v Račun123
- Webhook skrivnost (whsec_…)
- po potrebi vklopi:
- Samodejno davčno potrjevanje
- Samodejno pošiljanje računa po e-pošti
To je priporočena konfiguracija za večino uporabnikov in pokriva tako enkratne nakupe kakor tudi naročnine in nadgradnje.
5. Testiraj povezavo
V Stripe vklopi Test mode.
Testiraj vsaj:
- enkratno plačilo
- novo naročnino
- obnovo naročnine
- nadgradnjo obstoječe naročnine
Preveri:
- ali se pojavita ustrezna eventa v Stripe
- ali se zapis pojavi v dnevniku webhookov v Račun123
- ali se ustvari pravilen račun
Če uporabljaš Sandbox način v Račun123:
- dogodek se zabeleži v dnevnik
- račun se še ne ustvari zares
6. Vklopi avtomatiko
Ko test deluje, vklopi:
- ✅ Samodejno davčno potrjevanje
- ✅ Samodejno pošiljanje računa po e-pošti
Po potrebi nastavi še:
- oznako poslovnega prostora
- oznako naprave
- operaterja
7. Izklopi Sandbox
Ko vse dela:
Izklopi Sandbox način
👉 Od tega trenutka naprej se računi dejansko ustvarjajo.
Zakaj potrebujem oba eventa?
To pomeni, da se račun ne ustvari ob vsakem Stripe eventu, ampak ob pravem plačilnem eventu za posamezen scenarij.
Enkratno plačilo
- uporabnik opravi enkratni nakup
- Stripe pošlje checkout.session.completed
- Račun123 ustvari račun
Naročnina, obnova ali nadgradnja
- Stripe pogosto ne naredi novega checkouta
- ustvari invoice in po uspešnem plačilu pošlje invoice.paid
- Račun123 ustvari račun na invoice.paid
Če imaš enkratna plačila, je ključen checkout.session.completed. Če imaš naročnine, obnovitve ali nadgradnje, je ključen invoice.paid. Zato priporočamo, da nastaviš oba.
Hitra tabela: scenarij → kateri event ustvari račun?
| Scenarij | Glavni event za račun | Račun izdan? | Opomba |
|---|---|---|---|
| Enkratni nakup | checkout.session.completed | DA | Klasičen Stripe Checkout z uspešnim plačilom |
| Prva naročnina | checkout.session.completed in/ali invoice.paid | DA | Račun se izda ob uspešno plačanem začetku naročnine |
| Obnova naročnine | invoice.paid | DA | Ni novega checkouta, Stripe ustvari invoice |
| Nadgradnja paketa z doplačilom | invoice.paid | DA | Pogosto gre za proracijo ali razliko, ki jo Stripe zaračuna |
| Neuspešno plačilo naročnine | Ni uspešnega invoice.paid | NE | Če plačilo ni uspešno, se račun ne izda |
Če nekaj ne dela (hitri checklist)
Ni webhooka?
- Preveri URL
- Preveri ali si v pravem načinu (Test / Live)
Ni računa pri enkratnem plačilu?
- Preveri checkout.session.completed
- Preveri webhook nastavitve
Ni računa pri naročnini, obnovitvi ali nadgradnji?
- Preveri invoice.paid
- Preveri ali Stripe za ta scenarij sploh ustvari invoice
- Preveri logiko povezave med Stripe customerjem in podjetjem v Račun123
Ni emaila?
- Pošiljanje emaila ni vklopljeno
- Preveri nastavitve pošiljanja v Račun123
Pogosta vprašanja
Ali zadošča samo checkout.session.completed?
Ne, če uporabljaš naročnine. Za naročnine, obnovitve in nadgradnje potrebuješ tudi invoice.paid.
Ali moram v kodo pošiljati dodatne podatke, kot sta companyId ali customer email?
Ne nujno. Integracija lahko deluje tudi brez tega. V določenih implementacijah so ti podatki lahko še vedno koristni, niso pa več obvezna zahteva.
Ali se račun ustvari ob vsakem Stripe eventu?
Ne. Račun se ustvari ob eventu, ki pomeni dejansko uspešno plačilo za konkreten scenarij.
Ali se račun ustvari vsakič, ko podjetnik prejme denar prek Stripe?
Načeloma da. Pri enkratnih nakupih običajno ob checkout.session.completed, pri naročninah, obnovitvah in mnogih nadgradnjah pa ob invoice.paid.
Ali moram imeti davčno potrjevanje?
Če posluješ z gotovino, karticami ali spletnimi plačili, je to pogosto potrebno. Več si lahko prebereš v članku
Kdaj je davčno potrjevanje potrebno?.
Potrebuješ pomoč pri Stripe integraciji?
Če imaš težave pri povezavi Stripe ali se računi ne ustvarjajo pravilno, smo ti z veseljem na voljo.
Piši nam na podpora@racun123.si ali nam pošlji sporočilo prek
kontaktnega obrazca.
Skupaj bomo hitro preverili nastavitve in poskrbeli, da integracija deluje brezhibno.
