Dodatak omogućuje:
- obrazac za plaćanje,
- povijest plaćanja,
- automatsko dodavanje uplata u Galette nakon potvrde plaćanja.

Napomena — Instalacija Galettea mora biti javno dostupna i imati valjan SSL certifikat.
Instalacija
Najprije preuzmite dodatak:
Raspakirajte preuzetu arhivu u Galetteovu mapu plugins. Primjerice, na Linuxu
(zamijenite {url} i {version} odgovarajućim vrijednostima):
$ cd /var/www/html/galette/plugins
$ wget {url}
$ tar xjvf galette-plugin-stripe-{version}.tar.bz2
Inicijalizacija baze podataka
Dodatak zahtijeva nekoliko tablica u bazi. Pogledajte sučelje za upravljanje dodacima Galettea.
Gotovo; dodatak Stripe je instaliran. :)
Uporaba dodatka
Nakon instalacije prijavljenom se korisniku u izborniku pojavljuje odjeljak Stripe. Administratori i uprava mogu podesiti dodatak i pregledati povijest plaćanja.

Obrazac za plaćanje dostupan je na Galetteovim javnim stranicama.
Samo prijavljeni korisnici mogu izvršiti uplate koje produljuju članstvo, odnosno platiti članarinu.

Posjetitelji (neprijavljeni korisnici) mogu izvršiti samo uplate koje ne produljuju članstvo, odnosno donacije. U tom se slučaju uplata ne dodaje automatski u Galette, nego se plaćanje prikazuje samo u povijesti dodatka s vrijednošću „Nema” u stupcu „Član”.

Postavke

- URL krajnje točke Stripe webhooka: adresa za izradu webhooka u Stripe računu udruge (više u nastavku).
- Događaj Stripe webhooka: naziv događaja za izradu webhooka u Stripe računu udruge (više u nastavku).
- Javni ključ Stripea: nalazi se u Stripe računu udruge (više u nastavku).
- Tajni ključ Stripea: nalazi se u Stripe računu udruge (više u nastavku).
- Tajni ključ Stripe webhooka: nalazi se u pojedinostima webhooka koji trebate izraditi u Stripe računu udruge (više u nastavku).
- Država Stripe računa: odaberite državu prema postavkama Stripe računa (više u nastavku).
- Valuta plaćanja: odaberite valutu prema postavkama Stripe računa (više u nastavku).
-
Vrste uplata: u tablici možete isključiti vrste uplata podešene u Galetteu koje ne želite ponuditi kao svrhu plaćanja u obrascu.
Vrste uplata s iznosom nula ili bez zadanog iznosa neće se ponuditi kao svrha plaćanja, čak i ako nisu označene kao neaktivne u tablici.
Napomena — Opis ispod svake svrhe plaćanja možete zadati u postavkama vrsta uplata u Galetteu.
Napomena — U Galetteovim postavkama možete odrediti tko pristupa obrascu za plaćanje. Odaberite željenu opciju u postavkama vidljivosti javnih stranica.
Napomena o testnom načinu

Preporučuje se provjeriti dodatak u testnom okruženju. Upute za njegovo postavljanje potražite u dokumentaciji Stripea.
Upozorenje — U ovom načinu koristite isključivo testne kartice, nikada stvarne brojeve kartica. Popis testnih kartica nalazi se u dokumentaciji Stripea.
Podešavanje Stripe računa
Upute za izradu računa potražite u dokumentaciji Stripea.
Pronalaženje države i valute u postavkama računa
Država i valuta obično se odabiru pri izradi računa. Podatke možete pronaći u postavkama računa:

- Settings > Business > Account details (Postavke > Poslovanje > Podaci računa)

- Settings > Business > Bank accounts and currencies (Postavke > Poslovanje > Bankovni računi i valute)

Izrada webhooka i pronalaženje njegova tajnog ključa
Webhook potreban za rad dodatka možete izraditi u izborniku Developers (Razvojni alati), pri dnu lijevo na nadzornoj ploči:

Endpoint URL, odnosno adresu krajnje točke webhooka, pronaći ćete u postavkama
dodatka (primjer: https://YOUR_DOMAIN_NAME/plugins/stripe/webhook).
U webhooku treba zadati samo jedan Event (događaj). Naveden je i u postavkama
dodatka: payment_intent.succeeded.

Nakon izrade pronađite tajni ključ webhooka i unesite ga u postavke dodatka. U popisu webhookova kliknite onaj koji ste izradili:

Tajni ključ webhooka možete kopirati iz njegovih pojedinosti:

Pronalaženje API ključeva
API ključevi potrebni za rad dodatka dostupni su u izborniku Developers (Razvojni alati), pri dnu lijevo na nadzornoj ploči:

Napomena — Kako biste smanjili posljedice moguće kompromitacije, izradite Restricted key (ograničeni ključ). Možete ga izraditi bez prilagodbe ovlasti. Više informacija potražite u dokumentaciji Stripea.

Uključivanje potrebnih načina plaćanja
Stripe nudi mnoge načine plaćanja. U postavkama računa uključite samo one koje želite koristiti.
- Settings > Payments > Payment methods (Postavke > Plaćanja > Načini plaćanja)
