KIGO.CLOUD

Pregled Stripe integracije

Stripe integracija omogućuje automatsko fakturiranje, fiskalizaciju i slanje računa za plaćanja primljena preko Stripe platforme. Podržana su jednokratna plaćanja putem web checkout košarice kao i periodična plaćanja putem Stripe subscription invoicinga.

Integracija radi na temelju Stripe WebHooks mehanizma — prilikom transakcija ili promjena statusa na Stripe računu, podaci se automatski šalju u Kigo koja kreira dokument i fiskalizira ga.

Podržani vanjski sustavi

Osim izravnih Stripe naplata, automatski prepoznajemo i fiskaliziramo uplate koje kroz Stripe stižu iz ovih platformi:

  • Thinkific — platforma za online tečajeve
  • Wix — web stranice i webshop
  • Bokun — rezervacije izleta i turističkih usluga
  • Ostale platforme — svaka uplata koja uz Stripe transakciju nosi standardne metapodatke (e-pošta, broj narudžbe, stavke) prepoznaje se automatski

Kigo se uz Stripe izravno povezuje i s WooCommerce i Shopify webshopovima te nudi REST API za povezivanje vlastitih sustava.

Postavljanje WebHooka

Postupak za kreiranje Stripe WebHooka:

  1. Prijavite se u Stripe Dashboard na dashboard.stripe.com.
  2. Otvorite Developers → Webhooks i kliknite Add destination.
  3. U koraku Select events odaberite događaje koje želite pratiti:
    • invoice.payment_succeeded — kada je uplata uspješno izvršena
    • invoice.created — kada je račun kreiran na Stripeu
    • invoice.sent — kada je račun poslan kupcu
    • payment_intent.succeeded — kada je uplata bez računa uspješno potvrđena
  4. Odaberite Webhook endpoint kao tip destinacije.
  5. U polje Endpoint URL zalijepite adresu iz Kigo Stripe postavki.
  6. Kliknite Create destination za spremanje.

API ključ i Stripe Invoicing

Za naprednu integraciju (Stripe Invoicing) potreban je tajni API ključ koji omogućuje Kigu dohvaćanje dodatnih podataka iz Stripe sustava.

Postupak za dobivanje API ključa:

  1. U Stripe Dashboardu otvorite Developers → API keys.
  2. Kliknite Create secret key i unesite naziv (npr. Kigo).
  3. Kopirajte prikazani tajni ključ — prikazuje se samo jednom.
  4. U Kigu otvorite Stripe Invoicing tab Postavke i unesite ključ u predviđeno polje.

Važno: Tajni API ključ ne dijelite i ne šaljite putem e-maila.

Prednosti Stripe Invoice integracije

Webhook događaji koje Stripe šalje često ne sadrže sve informacije potrebne za izradu računa (ime kupca, e-mail, stavke narudžbe). Unosom tajnog API ključa omogućujete Kigu da automatski nadopuni te podatke dohvaćanjem iz Stripe sustava.

Dodatne mogućnosti uključuju:

  • Dohvaćanje detaljnih stavki računa iz Stripe invoicea
  • Povezivanje narudžbi sa stvarnim kupcima
  • Praćenje statusa plaćanja
  • Iniciranje izdavanja refundacija

Česta pitanja i napomene

  • Mogu li koristiti samo WebHook bez API ključa? Da, osnovna integracija putem WebHooka radi bez API ključa, ali podaci na računu mogu biti nepotpuni (npr. može nedostajati ime kupca).
  • Stripe šalje testne zahtjeve? Da, nakon kreiranja WebHooka Stripe šalje testne zahtjeve kako biste mogli provjeriti ispravnost integracije.
  • Koji event odabrati za payment_intent.succeeded? Ovaj event je podržan, ali obratite se podršci za dodatne informacije o konfiguraciji.
  • Što ako integracija ne radi? Provjerite ispravnost URL-a u Stripe Dashboardu, pregledajte log webhook isporuka i kontaktirajte Kigo podršku.

Integracije