Kod źródłowy Wiki Platební brány (Comgate, GoPay)
Ostatnio modyfikowane 2025/11/13 10:39 przez Jan Slezák
Ukryj ostatnich autorów
| author | version | line-number | content |
|---|---|---|---|
| |
2.1 | 1 | {{toc/}} |
| |
1.1 | 2 | |
| |
7.1 | 3 | = Wprowadzenie = |
| |
1.1 | 4 | |
| |
7.1 | 5 | System biblioteczny Tritius, moduł katalogu internetowego, umożliwia czytelnikom dokonywanie płatności kartą za określone operacje: |
| |
1.1 | 6 | |
| |
7.1 | 7 | * Opłacanie opłat (upomnienia, kary itp.) |
| 8 | * Przedłużenie rejestracji | ||
| |
1.1 | 9 | |
| |
7.1 | 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/]]. |
| |
1.1 | 11 | |
| |
7.1 | 12 | Biblioteka zawiera umowę bezpośrednio z dostawcą wybranej bramki. |
| |
1.1 | 13 | |
| |
7.1 | 14 | Moduł bramki płatniczej w katalogu systemu Tritius jest płatny zgodnie z cennikiem, w tym późniejsze aktualizacje. |
| |
1.1 | 15 | |
| |
7.1 | 16 | Biblioteka ma dostęp do interfejsu internetowego, gdzie może przeglądać rozliczenia i wyświetlać szczegóły płatności. |
| |
1.1 | 17 | |
| |
7.1 | 18 | = Opłata za przedłużenie rejestracji = |
| |
1.1 | 19 | |
| |
7.1 | 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”. | ||
| |
1.1 | 36 | |
| |
7.1 | 37 | ((( |
| 38 | = Płatność za zaległe opłaty = | ||
| 39 | ))) | ||
| |
1.1 | 40 | |
| |
7.1 | 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. | ||
| |
1.1 | 46 | |
| |
7.1 | 47 | = Brama płatnicza GoPay = |
| |
1.1 | 48 | |
| |
7.1 | 49 | == Warunki GoPay == |
| |
1.1 | 50 | |
| |
7.1 | 51 | Firma GoPay nie ma już niestety wspólnych warunków umownych dla bibliotek. |
| |
1.1 | 52 | |
| |
7.1 | 53 | Warunki umowne są teraz ustalane indywidualnie z każdą biblioteką, a na podstawie osiągniętego obrotu można uzgodnić korzystniejsze warunki. |
| |
1.1 | 54 | |
| |
7.1 | 55 | Poniższa tabela przedstawia orientacyjne ceny podane przez dział handlowy firmy GoPay w sierpniu 2019 r.: |
| |
1.1 | 56 | |
| |
3.1 | 57 | (% class="table-bordered" %) |
| |
7.1 | 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 | ||
| |
1.1 | 61 | |
| |
7.1 | 62 | == Rejestracja w GoPay == |
| |
1.1 | 63 | |
| |
7.1 | 64 | Najpierw należy zarejestrować się w firmie GoPay, korzystając z poniższego linku: |
| |
1.1 | 65 | |
| 66 | **[[https:~~/~~/registration.gopay.com/cs/signup-supplier/tritius>>url:https://registration.gopay.com/cs/signup-supplier/tritius]]** | ||
| 67 | |||
| 68 | |||
| |
7.1 | 69 | Poniżej znajduje się formularz, w którym należy podać między innymi następujące dane: |
| |
1.1 | 70 | |
| 71 | [[image:1722590771235-512.png||height="211" width="507"]] | ||
| 72 | |||
| 73 | |||
| |
7.1 | 74 | W tym miejscu należy podać adres własnego katalogu internetowego (najczęściej: <nazwa biblioteki>.tritius.cz). |
| |
1.1 | 75 | |
| |
7.1 | 76 | Nie należy zaznaczać pola, ponieważ strona internetowa jest publicznie dostępna. |
| |
1.1 | 77 | |
| |
7.1 | 78 | Będziesz sprzedawać: rejestrację i spłatę zadłużenia czytelników |
| |
1.1 | 79 | |
| |
7.1 | 80 | == Konfiguracja bramki w Tritiu == |
| |
1.1 | 81 | |
| |
7.1 | 82 | Korzystanie z bramki płatniczej w katalogu należy włączyć i skonfigurować. |
| |
1.1 | 83 | |
| |
3.1 | 84 | (% class="table-bordered" %) |
| |
1.1 | 85 | |=((( |
| |
7.1 | 86 | Klucz |
| |
1.1 | 87 | )))|=((( |
| 88 | Typ | ||
| 89 | )))|=(% colspan="1" %)((( | ||
| |
7.1 | 90 | Opis |
| |
1.1 | 91 | ))) |
| |
7.1 | 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. | ||
| |
1.1 | 98 | |(% colspan="1" %)GOPAY_URL|(% colspan="1" %)String|(% colspan="1" %)((( |
| |
7.1 | 99 | Adres URL bramki GoPay. |
| |
1.1 | 100 | |
| |
5.1 | 101 | {{{https://gate.gopay.cz/api/}}} |
| |
1.1 | 102 | ))) |
| |
5.1 | 103 | |(% colspan="1" %)GOPAY_ID|(% colspan="1" %)String|(% colspan="1" %)((( |
| |
7.1 | 104 | Identyfikator klienta GoPay. |
| |
5.1 | 105 | |
| |
7.1 | 106 | //Otrzymasz po podpisaniu umowy z GoPay.// |
| |
5.1 | 107 | ))) |
| 108 | |(% colspan="1" %)GOPAY_CLIENT_ID|(% colspan="1" %)String|(% colspan="1" %)((( | ||
| |
7.1 | 109 | Numer klienta GoPay dla API. |
| |
5.1 | 110 | |
| |
7.1 | 111 | //Otrzymasz po podpisaniu umowy z GoPay.// |
| |
5.1 | 112 | ))) |
| 113 | |(% colspan="1" %)GOPAY_SECRET_KEY|(% colspan="1" %)String|(% colspan="1" %)((( | ||
| |
7.1 | 114 | Hasło GoPay do API. |
| |
5.1 | 115 | |
| |
7.1 | 116 | //Otrzymasz po podpisaniu umowy z GoPay.// |
| |
5.1 | 117 | ))) |
| |
7.1 | 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. |
| |
1.1 | 119 | |(% colspan="1" %)CATALOG_ENABLE_PAYMENTS|(% colspan="1" %)Boolean|(% colspan="1" %)((( |
| |
7.1 | 120 | Zezwolenie na płatności w katalogu. Domyślnie włączone. Można ustawić dla poszczególnych użytkowników. |
| |
1.1 | 121 | |
| |
7.1 | 122 | Odpowiednie np. do zezwolenia jednemu użytkownikowi na testowanie bramki płatniczej. |
| |
1.1 | 123 | ))) |
| 124 | |||
| |
7.1 | 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]] |
| |
1.1 | 126 | |
| |
7.1 | 127 | Podczas edycji szablonu HTML należy **zachować domyślną strukturę tagów** i wpisać własny tekst między te tagi. |
| |
1.1 | 128 | |
| |
7.1 | 129 | Inspiracją mogą służyć biblioteki, które już sporządziły warunki handlowe: |
| 130 | |||
| |
1.1 | 131 | |
| 132 | * [[http:~~/~~/knih-kt.cz/VOP_GoPay_Tritius.php>>url:http://knih-kt.cz/VOP_GoPay_Tritius.php]] | ||
| 133 | |||
| |
7.1 | 134 | = Brama płatnicza Comgate = |
| |
1.1 | 135 | |
| 136 | Web: [[https:~~/~~/www.comgate.cz/cz>>url:https://www.comgate.cz/cz]] | ||
| 137 | |||
| |
7.1 | 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]] | ||
| |
1.1 | 141 | |
| |
7.1 | 142 | **Zawarcie umowy: [[https:~~/~~/help.comgate.cz/docs/smlouva-online>>url:https://help.comgate.cz/docs/smlouva-online]]** |
| |
1.1 | 143 | |
| 144 | |||
| |
7.1 | 145 | Artykuły: |
| |
1.1 | 146 | |
| |
7.1 | 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) | ||
| |
1.1 | 149 | |
| |
7.1 | 150 | == Warunki płatności == |
| |
1.1 | 151 | |
| |
7.1 | 152 | === **Opłaty jednorazowe** === |
| |
1.1 | 153 | |
| |
3.1 | 154 | (% class="table-bordered" %) |
| |
7.1 | 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č | ||
| |
1.1 | 161 | |
| |
7.1 | 162 | === **Miesięczne opłaty za zarządzanie i procentowe opłaty od transakcji** === |
| |
1.1 | 163 | |
| |
3.1 | 164 | (% class="table-bordered" %) |
| |
7.1 | 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č | ||
| |
1.1 | 168 | |
| |
7.1 | 169 | === **Stałe opłaty transakcyjne** === |
| |
1.1 | 170 | |
| |
3.1 | 171 | (% class="table-bordered" %) |
| |
7.1 | 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 | ||
| |
1.1 | 175 | |
| |
7.1 | 176 | == Konfiguracja bramki w Tritiu == |
| |
1.1 | 177 | |
| |
7.1 | 178 | Korzystanie z bramki płatniczej w katalogu należy włączyć i skonfigurować. |
| |
1.1 | 179 | |
| |
3.1 | 180 | (% class="table-bordered" %) |
| |
1.1 | 181 | |=((( |
| |
7.1 | 182 | Klucz |
| |
1.1 | 183 | )))|=((( |
| 184 | Typ | ||
| 185 | )))|=(% colspan="1" %)((( | ||
| |
7.1 | 186 | Opis |
| |
1.1 | 187 | ))) |
| |
7.1 | 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. | ||
| |
4.1 | 193 | |(% colspan="1" %)((( |
| 194 | IS_ENABLED_TO_PROLONG_EXPIRED_REGISTRATIONS | ||
| |
7.1 | 195 | )))|(% colspan="1" %)Boolean|(% colspan="1" %)Zezwolenie na przedłużenie wygasłej rejestracji w katalogu |
| |
1.1 | 196 | |(% colspan="1" %)COMGATE_MERCHANT|(% colspan="1" %)String|(% colspan="1" %)((( |
| |
7.1 | 197 | Identyfikator klienta Comgate |
| |
1.1 | 198 | |
| |
7.1 | 199 | Otrzymasz po podpisaniu umowy z Comgate. |
| |
1.1 | 200 | ))) |
| 201 | |(% colspan="1" %)COMGATE_SECRET|(% colspan="1" %)String|(% colspan="1" %)((( | ||
| |
7.1 | 202 | Hasło |
| |
1.1 | 203 | |
| |
7.1 | 204 | Otrzymasz po podpisaniu umowy z Comgate. |
| |
1.1 | 205 | ))) |
| |
7.1 | 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. | ||
| |
1.1 | 208 | |(% colspan="1" %)CATALOG_ENABLE_PAYMENTS|(% colspan="1" %)Boolean|(% colspan="1" %)((( |
| |
7.1 | 209 | Zezwolenie na płatności w katalogu. Domyślnie włączone. Można ustawić dla poszczególnych użytkowników. |
| |
1.1 | 210 | |
| |
7.1 | 211 | Przydatne np. do zezwolenia jednemu użytkownikowi na testowanie bramki płatniczej. |
| |
1.1 | 212 | ))) |
| 213 | |||
| |
7.1 | 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]] |
| |
1.1 | 215 | |
| |
7.1 | 216 | Podczas edycji szablonu HTML należy **zachować domyślną strukturę** tagów i wpisać własny tekst pomiędzy tymi tagami. |
| |
1.1 | 217 | |
| |
7.1 | 218 | == Konfiguracja bramy w Comgate == |
| |
1.1 | 219 | |
| |
7.1 | 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.** |
| |
1.1 | 221 | |
| |
7.1 | 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]] |
| |
1.1 | 223 | |
| |
3.1 | 224 | (% class="table-bordered" %) |
| |
7.1 | 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. | ||
| |
1.1 | 231 | |
| |
7.1 | 232 | == Referencje == |
| |
1.1 | 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) |