Kod źródłowy Wiki Platební brány (Comgate, GoPay)
Ostatnio modyfikowane 2025/11/13 10:08 przez Jan Slezák
Pokaż ostatnich autorów
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{toc/}} | ||
| 2 | |||
| 3 | = Wprowadzenie = | ||
| 4 | |||
| 5 | System biblioteczny Tritius, moduł katalogu internetowego, umożliwia czytelnikom dokonywanie płatności kartą za określone operacje: | ||
| 6 | |||
| 7 | * Opłacanie opłat (upomnienia, kary itp.) | ||
| 8 | * Przedłużenie rejestracji | ||
| 9 | |||
| 10 | Do płatności kartą Tritius korzysta z usług bramki płatniczej [[Comgate>>url:https://www.comgate.cz/cz]]lub [[GoPay>>url:https://gopay.com/cs/]]. | ||
| 11 | |||
| 12 | Biblioteka zawiera umowę bezpośrednio z dostawcą wybranej bramki. | ||
| 13 | |||
| 14 | Moduł bramki płatniczej w katalogu systemu Tritius jest płatny zgodnie z cennikiem, w tym późniejsze aktualizacje. | ||
| 15 | |||
| 16 | Biblioteka ma dostęp do interfejsu internetowego, gdzie może przeglądać rozliczenia i wyświetlać szczegóły płatności. | ||
| 17 | |||
| 18 | = Opłata za przedłużenie rejestracji = | ||
| 19 | |||
| 20 | * Przedłużenie rejestracji za pośrednictwem katalogu musi być dozwolone przez ustawienie: CATALOG_REGISTRATION_PROLONGATION_ENABLED | ||
| 21 | ** Przed wygaśnięciem rejestracji w katalogu czytelnik otrzyma powiadomienie o jej wygaśnięciu. | ||
| 22 | * Termin wyświetlenia powiadomienia można skorygować poprzez ustawienie: CATALOG_REGISTRATION_PROLONGATION_PERIOD | ||
| 23 | ** Po kliknięciu na powiadomienie o wygasającej rejestracji wyświetli się strona z listą wygasających rejestracji. | ||
| 24 | ** Może być więcej rejestracji w różnych działach. | ||
| 25 | ** Czytelnik może przedłużyć poszczególne rejestracje, klikając przycisk „Przedłuż rejestrację”. | ||
| 26 | *** Po kliknięciu przycisku „Przedłuż rejestrację” czytelnikowi wyświetli się strona z podsumowaniem informacji: | ||
| 27 | *** Od kiedy nowa rejestracja będzie ważna. | ||
| 28 | *** Do kiedy nowa rejestracja będzie ważna. | ||
| 29 | *** W jakich działach rejestracja będzie ważna (w tym w działach powiązanych). | ||
| 30 | *** Pole wyboru potwierdzające, że czytelnik zgadza się z regulaminem biblioteki (ewentualnie link do regulaminu biblioteki). | ||
| 31 | *** Na końcu strony dostępne będą dwie opcje: | ||
| 32 | **** Potwierdź i zapłać – wyświetli się płatność kartą, czytelnik dokona płatności, a rejestracja będzie w pełni ważna. | ||
| 33 | **** Potwierdź i utwórz zadłużenie – zostanie utworzone zadłużenie i przedłużona rejestracja. Czytelnik może nadal korzystać z usług biblioteki, ale niektóre z nich mogą być ograniczone. | ||
| 34 | * Po pierwszym przyjściu do biblioteki po przedłużeniu za pomocą karty bibliotekarzowi wyświetlą się informacje (aby mógł sprawdzić dane). | ||
| 35 | * Listę aktywnych rejestracji czytelnik może również wyświetlić w menu użytkownika pod linkiem „Moje rejestracje”. | ||
| 36 | |||
| 37 | ((( | ||
| 38 | = Płatność za zaległe opłaty = | ||
| 39 | ))) | ||
| 40 | |||
| 41 | * W menu czytelnika wyświetlana jest całkowita kwota zadłużenia czytelnika. | ||
| 42 | * W menu czytelnika, pod linkiem „Moje opłaty”, wyświetlana jest również kwota aktualnie należnych opłat. | ||
| 43 | * Po kliknięciu na całkowitą kwotę wyświetla się lista należnych opłat. | ||
| 44 | * Jeśli płatności kartą są dozwolone, pod wyciągiem pojawi się przycisk „Zapłać”, który przekieruje czytelnika do bramki płatniczej GoPay i umożliwi mu uregulowanie należnych opłat. | ||
| 45 | * Katalog zawiera ustawienie **PAYMENT_GATE_MINIMAL_AMOUNT** określające minimalną kwotę, jaką można zapłacić za pomocą bramki płatniczej. | ||
| 46 | |||
| 47 | = Brama płatnicza GoPay = | ||
| 48 | |||
| 49 | == Warunki GoPay == | ||
| 50 | |||
| 51 | Firma GoPay nie ma już niestety wspólnych warunków umownych dla bibliotek. | ||
| 52 | |||
| 53 | Warunki umowne są teraz ustalane indywidualnie z każdą biblioteką, a na podstawie osiągniętego obrotu można uzgodnić korzystniejsze warunki. | ||
| 54 | |||
| 55 | Poniższa tabela przedstawia orientacyjne ceny podane przez dział handlowy firmy GoPay w sierpniu 2019 r.: | ||
| 56 | |||
| 57 | (% class="table-bordered" %) | ||
| 58 | |=Miesięczny obrót (w CZK)|=rabat z przenoszonej kwoty|=ryczałtowa kwota za transakcję | ||
| 59 | |do obrotu 8 700 PLN|2,2 % od kwoty|+ 0,5 PLN | ||
| 60 | |8 700 - 17 500 PLN|1,7 % od kwoty|+ 0,5 PLN | ||
| 61 | |||
| 62 | == Rejestracja w GoPay == | ||
| 63 | |||
| 64 | Najpierw należy zarejestrować się w firmie GoPay, korzystając z poniższego linku: | ||
| 65 | |||
| 66 | **[[https:~~/~~/registration.gopay.com/cs/signup-supplier/tritius>>url:https://registration.gopay.com/cs/signup-supplier/tritius]]** | ||
| 67 | |||
| 68 | |||
| 69 | Poniżej znajduje się formularz, w którym należy podać między innymi następujące dane: | ||
| 70 | |||
| 71 | [[image:1722590771235-512.png||height="211" width="507"]] | ||
| 72 | |||
| 73 | |||
| 74 | W tym miejscu należy podać adres własnego katalogu internetowego (najczęściej: <nazwa biblioteki>.tritius.cz). | ||
| 75 | |||
| 76 | Nie należy zaznaczać pola, ponieważ strona internetowa jest publicznie dostępna. | ||
| 77 | |||
| 78 | Będziesz sprzedawać: rejestrację i spłatę zadłużenia czytelników | ||
| 79 | |||
| 80 | == Konfiguracja bramki w Tritiu == | ||
| 81 | |||
| 82 | Korzystanie z bramki płatniczej w katalogu należy włączyć i skonfigurować. | ||
| 83 | |||
| 84 | (% class="table-bordered" %) | ||
| 85 | |=((( | ||
| 86 | Klucz | ||
| 87 | )))|=((( | ||
| 88 | Typ | ||
| 89 | )))|=(% colspan="1" %)((( | ||
| 90 | Opis | ||
| 91 | ))) | ||
| 92 | |(% colspan="1" %)CATALOG_SHOW_TERMS_AND_CONDITIONS_PAGE|(% colspan="1" %)Boolean|(% colspan="1" %)Zezwolenie na wyświetlenie strony z warunkami płatności | ||
| 93 | |(% colspan="1" %)CATALOG_SHOW_PRICE_LIST_PAGE|(% colspan="1" %)Boolean|(% colspan="1" %)Zezwól na wyświetlenie strony z cennikiem | ||
| 94 | |CATALOG_CARD_PAYMENT_ENABLED|Boolean|(% colspan="1" %)Zezwolenie na płatności kartą w katalogu | ||
| 95 | |(% colspan="1" %)CATALOG_REGISTRATION_PROLONGATION_ENABLED|(% colspan="1" %)Boolean|(% colspan="1" %)Zezwolenie na przedłużenie rejestracji | ||
| 96 | |(% colspan="1" %)CATALOG_REGISTRATION_PROLONGATION_PERIOD|(% colspan="1" %)Int|(% colspan="1" %)Liczba dni do końca rejestracji, od kiedy można ją przedłużyć. Domyślnie jest to 31 dni. | ||
| 97 | |(% colspan="1" %)IS_ENABLED_TO_PROLONG_EXPIRED_REGISTRATIONS|(% colspan="1" %)Boolean|(% colspan="1" %)Zezwolenie na przedłużenie wygasłej rejestracji w katalogu. | ||
| 98 | |(% colspan="1" %)GOPAY_URL|(% colspan="1" %)String|(% colspan="1" %)((( | ||
| 99 | Adres URL bramki GoPay. | ||
| 100 | |||
| 101 | {{{https://gate.gopay.cz/api/}}} | ||
| 102 | ))) | ||
| 103 | |(% colspan="1" %)GOPAY_ID|(% colspan="1" %)String|(% colspan="1" %)((( | ||
| 104 | Identyfikator klienta GoPay. | ||
| 105 | |||
| 106 | //Otrzymasz po podpisaniu umowy z GoPay.// | ||
| 107 | ))) | ||
| 108 | |(% colspan="1" %)GOPAY_CLIENT_ID|(% colspan="1" %)String|(% colspan="1" %)((( | ||
| 109 | Numer klienta GoPay dla API. | ||
| 110 | |||
| 111 | //Otrzymasz po podpisaniu umowy z GoPay.// | ||
| 112 | ))) | ||
| 113 | |(% colspan="1" %)GOPAY_SECRET_KEY|(% colspan="1" %)String|(% colspan="1" %)((( | ||
| 114 | Hasło GoPay do API. | ||
| 115 | |||
| 116 | //Otrzymasz po podpisaniu umowy z GoPay.// | ||
| 117 | ))) | ||
| 118 | |(% colspan="1" %)PAYMENT_GATE_MINIMAL_AMOUNT |(% colspan="1" %)Int|(% colspan="1" %)Minimalna kwota, jaką można zapłacić za pośrednictwem bramki. Domyślnie 10 CZK. | ||
| 119 | |(% colspan="1" %)CATALOG_ENABLE_PAYMENTS|(% colspan="1" %)Boolean|(% colspan="1" %)((( | ||
| 120 | Zezwolenie na płatności w katalogu. Domyślnie włączone. Można ustawić dla poszczególnych użytkowników. | ||
| 121 | |||
| 122 | Odpowiednie np. do zezwolenia jednemu użytkownikowi na testowanie bramki płatniczej. | ||
| 123 | ))) | ||
| 124 | |||
| 125 | Brama płatnicza GoPay wymaga obecności warunków handlowych na stronie instytucji. Tritius posiada w tym celu oddzielną stronę, do której prowadzi link z stopki katalogu i która jest zdefiniowana w ustawieniach **szablonu HTML katalogu**. Zobacz na przykład: [[https:~~/~~/klatovy.tritius.cz/page/terms-and-conditions>>url:https://klatovy.tritius.cz/page/terms-and-conditions]] | ||
| 126 | |||
| 127 | Podczas edycji szablonu HTML należy **zachować domyślną strukturę tagów** i wpisać własny tekst między te tagi. | ||
| 128 | |||
| 129 | Inspiracją mogą służyć biblioteki, które już sporządziły warunki handlowe: | ||
| 130 | |||
| 131 | |||
| 132 | * [[http:~~/~~/knih-kt.cz/VOP_GoPay_Tritius.php>>url:http://knih-kt.cz/VOP_GoPay_Tritius.php]] | ||
| 133 | |||
| 134 | = Brama płatnicza Comgate = | ||
| 135 | |||
| 136 | Web: [[https:~~/~~/www.comgate.cz/cz>>url:https://www.comgate.cz/cz]] | ||
| 137 | |||
| 138 | [[Aktualny cennik: >>url:https://www.comgate.cz/cz]][[https:~~/~~/www.comgate.cz/cz/cena>>url:https://www.comgate.cz/cz/cena]] | ||
| 139 | [[Portal klienta: >>url:https://www.comgate.cz/cz]][[https:~~/~~/portal.comgate.cz/cs/site/index>>url:https://portal.comgate.cz/cs/site/index]] | ||
| 140 | [[Dokumentacja: >>url:https://www.comgate.cz/cz]][[https:~~/~~/portal.comgate.cz/cs/dokumentace>>url:https://portal.comgate.cz/cs/dokumentace]] | ||
| 141 | |||
| 142 | **Zawarcie umowy: [[https:~~/~~/help.comgate.cz/docs/smlouva-online>>url:https://help.comgate.cz/docs/smlouva-online]]** | ||
| 143 | |||
| 144 | |||
| 145 | Artykuły: | ||
| 146 | |||
| 147 | * Porównanie bram płatniczych: [[https:~~/~~/www.comgate.cz/cz/blog/srovnani-platebnich-bran>>url:https://www.comgate.cz/cz/blog/srovnani-platebnich-bran]] | ||
| 148 | * Starszy: [[https:~~/~~/www.kutac.cz/weby-a-vse-okolo/platebni-brana-comgate>>url:https://www.kutac.cz/weby-a-vse-okolo/platebni-brana-comgate]] (zawiera nieaktualne informacje) | ||
| 149 | |||
| 150 | == Warunki płatności == | ||
| 151 | |||
| 152 | === **Opłaty jednorazowe** === | ||
| 153 | |||
| 154 | (% class="table-bordered" %) | ||
| 155 | |Ustanowienie bramki płatniczej|0,- | ||
| 156 | |(% colspan="1" %)Codzienne przelewy pieniędzy na konto bankowe klienta|(% colspan="1" %)0,- | ||
| 157 | |(% colspan="1" %)EET w bramce płatniczej|(% colspan="1" %)0,- | ||
| 158 | |(% colspan="1" %)Anulowanie bramki płatniczej|(% colspan="1" %)0,- | ||
| 159 | |Zwrot pieniędzy (zwrot środków pieniężnych płatnikowi na wniosek klienta)|2 Kč | ||
| 160 | |Chargeback (przymusowy zwrot środków pieniężnych płatnikowi na podstawie skargi płatnika)|990 Kč | ||
| 161 | |||
| 162 | === **Miesięczne opłaty za zarządzanie i procentowe opłaty od transakcji** === | ||
| 163 | |||
| 164 | (% class="table-bordered" %) | ||
| 165 | |=Miesięczny wolumen transakcji|do 100.000 kč/měsíc|(% colspan="1" %)100.000-500.000 kč/měsíc|(% colspan="1" %)500.000kč-3 mil Kč/měsíc | ||
| 166 | |=Opłata miesięczna|149 Kč|(% colspan="1" %)99 Kč|(% colspan="1" %)0 Kč | ||
| 167 | |=(% colspan="1" %)Opłata transakcyjna|(% colspan="1" %)0,99% + 0,- Kč|(% colspan="1" %)0,89% + 0,- Kč|(% colspan="1" %)0,79% + 0,- Kč | ||
| 168 | |||
| 169 | === **Stałe opłaty transakcyjne** === | ||
| 170 | |||
| 171 | (% class="table-bordered" %) | ||
| 172 | |Płatności kartą|0 Kč | ||
| 173 | |(% colspan="1" %)Przyciski płatnicze w Czechach|(% colspan="1" %)0 Kč | ||
| 174 | |(% colspan="1" %)Przyciski płatnicze na Słowacji|(% colspan="1" %)0,2 EUR | ||
| 175 | |||
| 176 | == Konfiguracja bramki w Tritiu == | ||
| 177 | |||
| 178 | Korzystanie z bramki płatniczej w katalogu należy włączyć i skonfigurować. | ||
| 179 | |||
| 180 | (% class="table-bordered" %) | ||
| 181 | |=((( | ||
| 182 | Klucz | ||
| 183 | )))|=((( | ||
| 184 | Typ | ||
| 185 | )))|=(% colspan="1" %)((( | ||
| 186 | Opis | ||
| 187 | ))) | ||
| 188 | |CATALOG_SHOW_TERMS_AND_CONDITIONS_PAGE|Boolean|Zezwolenie na wyświetlenie strony z warunkami płatności | ||
| 189 | |CATALOG_SHOW_PRICE_LIST_PAGE|Boolean|Zezwól na wyświetlenie strony z cennikiem | ||
| 190 | |CATALOG_CARD_PAYMENT_ENABLED|Boolean|(% colspan="1" %)Zezwolenie na płatności kartą w katalogu | ||
| 191 | |(% colspan="1" %)CATALOG_REGISTRATION_PROLONGATION_ENABLED|(% colspan="1" %)Boolean|(% colspan="1" %)Zezwolenie na przedłużenie rejestracji | ||
| 192 | |(% colspan="1" %)CATALOG_REGISTRATION_PROLONGATION_PERIOD|(% colspan="1" %)Int|(% colspan="1" %)Liczba dni do końca rejestracji, od kiedy można przedłużyć rejestrację. Domyślnie jest to 31 dni. | ||
| 193 | |(% colspan="1" %)((( | ||
| 194 | IS_ENABLED_TO_PROLONG_EXPIRED_REGISTRATIONS | ||
| 195 | )))|(% colspan="1" %)Boolean|(% colspan="1" %)Zezwolenie na przedłużenie wygasłej rejestracji w katalogu | ||
| 196 | |(% colspan="1" %)COMGATE_MERCHANT|(% colspan="1" %)String|(% colspan="1" %)((( | ||
| 197 | Identyfikator klienta Comgate | ||
| 198 | |||
| 199 | Otrzymasz po podpisaniu umowy z Comgate. | ||
| 200 | ))) | ||
| 201 | |(% colspan="1" %)COMGATE_SECRET|(% colspan="1" %)String|(% colspan="1" %)((( | ||
| 202 | Hasło | ||
| 203 | |||
| 204 | Otrzymasz po podpisaniu umowy z Comgate. | ||
| 205 | ))) | ||
| 206 | |(% colspan="1" %)COMGATE_TEST|(% colspan="1" %)Boolean|(% colspan="1" %)Oznaczenie trybu testowego. Konieczny jest dostęp do trybu testowego Comgate. | ||
| 207 | |(% colspan="1" %)PAYMENT_GATE_MINIMAL_AMOUNT|(% colspan="1" %)Int|(% colspan="1" %)Minimalna kwota, jaką można zapłacić za pośrednictwem bramki. Domyślnie 10 CZK. | ||
| 208 | |(% colspan="1" %)CATALOG_ENABLE_PAYMENTS|(% colspan="1" %)Boolean|(% colspan="1" %)((( | ||
| 209 | Zezwolenie na płatności w katalogu. Domyślnie włączone. Można ustawić dla poszczególnych użytkowników. | ||
| 210 | |||
| 211 | Przydatne np. do zezwolenia jednemu użytkownikowi na testowanie bramki płatniczej. | ||
| 212 | ))) | ||
| 213 | |||
| 214 | Brama płatnicza Comgate wymaga obecności warunków handlowych na stronie instytucji. Tritius posiada w tym celu oddzielną stronę, do której prowadzi link z stopki katalogu i która jest zdefiniowana w ustawieniach **szablonu HTML katalogu**. Zobacz na przykład: [[https:~~/~~/katalog.svkul.cz/page/terms-and-conditions>>url:https://katalog.svkul.cz/page/terms-and-conditions]] | ||
| 215 | |||
| 216 | Podczas edycji szablonu HTML należy **zachować domyślną strukturę** tagów i wpisać własny tekst pomiędzy tymi tagami. | ||
| 217 | |||
| 218 | == Konfiguracja bramy w Comgate == | ||
| 219 | |||
| 220 | W ustawieniach bramki płatniczej Comgate należy skonfigurować adresy UR tak, aby kierowały do Tritius. **Menu główne → Integracja → Ustawienia sklepów.** | ||
| 221 | |||
| 222 | Dokumentacja Comgate: [[https:~~/~~/help.comgate.cz/docs/navod-k-pouziti#propojen%C3%AD-obchodu>>url:https://help.comgate.cz/docs/navod-k-pouziti#propojen%C3%AD-obchodu]] | ||
| 223 | |||
| 224 | (% class="table-bordered" %) | ||
| 225 | |=Parametr|=Wartość | ||
| 226 | |(% colspan="1" %)URL opłacony|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/paid?id=${id}&refId=${refId} | ||
| 227 | |(% colspan="1" %)URL usunięty|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/canceled?id=${id}&refId=${refId} | ||
| 228 | |(% colspan="1" %)URL nieprzetworzony|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/pending?id=${id}&refId=${refId} | ||
| 229 | |(% colspan="1" %)URL do przekazania wyniku płatności|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/status | ||
| 230 | |(% colspan="1" %)Dozwolone adresy IP|(% colspan="1" %)Adres IP VM lub proxy. | ||
| 231 | |||
| 232 | == Referencje == | ||
| 233 | |||
| 234 | * 07/2020 - Severočeská vědecká knihovna Ústí nad Labem (Comgate) | ||
| 235 | * 08/2020 - Knihovna Města Ostravy (Comgate) | ||
| 236 | * 09/2020 - Městská knihovna Třinec (Comgate) | ||
| 237 | * 10/2020 - Městská knihovna Klatovy (GoPay) | ||
| 238 | * 03/2021 - Městská knihovna Hodonín (Comgate) | ||
| 239 | * 04/2021 - Městská knihovna Jindřichův Hradec (Comgate) | ||
| 240 | * 05/2021 - Městská knihovna Jihlava (Comgate) |