Ta vtičnik zagotavlja:
- obrazec za plačilo,
- zgodovino plačil,
- samodejno ustvarjanje prispevkov v Galette, ko so plačila potrjena.
Warning — Ta vtičnik trenutno zahteva nočno različico Galette, zato trenutno ni priporočljivo, da bi ga uporabljali v proizvodnji.
Note — Če želite uporabljati ta vtičnik, mora biti vaš primerek Galette javno dostopen in postrežen na https.
Namestitev
Najprej prenesite vtičnik:
Ekstrahirajte preneseni arhiv v imenik Galette plugins. Na primer v linuxu
(zamenjava {url} in {version} z ustreznima vrednostma):
$ cd /var/www/html/galette/plugins
$ wget {url}
$ tar xjvf galette-plugin-stripe-{version}.tar.bz2
Inicializacija baze podatkov
Za delovanje ta vtičnik potrebuje več tabel v bazi podatkov. Oglejte si vmesnik za upravljanje vtičnikov Galette.
In to je to, vtičnik Stripe je nameščen. :)
Uporaba vtičnika
Ko je vtičnik nameščen, je skupina Stripe dodana v meni Galette, ko je uporabnik prijavljen, kar omogoča skrbnikom in članom osebja, da določijo nastavitve vtičnika in si ogledajo zgodovino plačil.
Obrazec za plačilo je dostopen na javnih straneh Galette.
Prispevke s podaljšanjem članstva (oz. članarino) lahko plačujejo le uporabniki, ki so prijavljeni v svoj račun.
Redni obiskovalci (uporabniki, ki niso prijavljeni v svoj račun) lahko plačajo samo prispevke brez podaljšanja članstva (ali donacije). V tem primeru se prispevek v Galette ne ustvari samodejno, plačilo se pojavi samo v zgodovini plačil vtičnika z vrednostjo “Brez“, vneseno v stolpcu “Član“.
Nastavitve
- URL končne točke webhooka Stripe: URL za ustvarjanje “Webhooka“ v računu vašega združenja na Stripe (preberite več spodaj).
- Dogodek webhook Stripe: ime dogodka za ustvarjanje “Webhooka“ v računu vašega združenja na Stripe (preberite več spodaj).
- Javni ključ Stripe: te informacije boste našli v računu svojega združenja na Stripe (preberite več spodaj).
- Skrivni ključ Stripe: te informacije boste našli v računu svojega združenja na Stripe (preberite več spodaj).
- Skrivni ključ webhooka Stripe: te informacije boste našli v podrobnostih o “Webhooku”, ki ga morate ustvariti v računu svojega združenja na Stripe (preberite več spodaj).
- Država vašega računa Stripe: izberite državo glede na nastavitve vašega računa Stripe (preberite več spodaj).
- Valuta za plačila: izberite valuto glede na nastavitve računa Stripe (preberite več spodaj).
-
Vrste prispevkov: v tej tabeli lahko onemogočite vrste prispevkov, konfigurirane v Galette, za katere ne želite, da so ponujene kot razlog za plačilo na obrazcu za spletno plačilo.
Vrste prispevkov z ničelnim zneskom ali katerih znesek ni konfiguriran, ne bodo ponujeni kot razlogi za plačilo na obrazcu, tudi če v tabeli niso označeni kot neaktivni.
Opomba o načinu peskovnika
Priporočamo, da preizkusite delovanje vtičnika v načinu peskovnika. Če želite izvedeti, kako nastaviti takšno testno okolje, si oglejte dokumentacijo Stripe.
Warning — V tem načinu ne uporabljajte pravih številk kreditnih kartic, ampak samo testne kartice (glejte seznam testnih kartic v dokumentaciji Stripe)
Konfigurirajte svoj račun Stripe
Če želite izvedeti, kako ustvariti račun, si oglejte dokumentacijo Stripe.
V nastavitvah računa določite državo in valuto
Izbira države in valute se običajno zahteva pri ustvarjanju vašega računa. Te informacije najdete v nastavitvah računa:
- Nastavitve > Podjetje > Podrobnosti računa
- Nastavitve > Podjetje > Bančni računi in valute
Ustvarite Webhook in pridobite ustrezen skrivni ključ
Webhook, ki je potreben za pravilno delovanje vtičnika, lahko ustvarite v meniju Razvijalci (nahaja se na spodnji levi strani vaše nadzorne plošče):
URL končne točke, ki ga želite določiti v svojem webhooku, je naveden v
nastavitvah vtičnika (primer:
https://YOUR_DOMAIN_NAME/plugins/stripe/webhook).
Samo en Event mora biti definiran v vašem webhooku. Navedeno je tudi v
nastavitvah vtičnika; je payment_intent.succeeded.
Ko je ustvarjen, morate dobiti skrivni ključ webhook, ki ga želite določiti v nastavitvah vtičnika. Na seznamu webhookov kliknite tistega, ki ste ga ustvarili:
Skrivni ključ webhooka je mogoče kopirati iz njegovih podrobnosti:
Pridobite ključe API
API ključe, ki so potrebni za pravilno delovanje vtičnika, lahko dobite v meniju Razvijalci (nahaja se v spodnjem levem kotu nadzorne plošče):
Note — Če želite zmanjšati potencialni vpliv kompromisa, ustvarite Omejeni ključ. Ta ključ je mogoče ustvariti brez prilagajanja dovoljenj. Za več informacij o omejenih ključih si oglejte dokumentacijo Stripe.
Omogočite potrebne načine plačila
Stripe ponuja veliko načinov plačila. V nastavitvah računa morate omogočiti samo metode, ki jih želite uporabiti.
- Nastavitve > Plačila > Plačilna sredstva
