Bramki płatnicze (Comgate, GoPay)

Ostatnio modyfikowane 2025/11/13 10:39 przez Jan Slezák

Wprowadzenie

System biblioteczny Tritius, moduł katalogu internetowego, umożliwia czytelnikom dokonywanie płatności kartą za określone operacje:

  • Opłacanie opłat (upomnienia, kary itp.)
  • Przedłużenie rejestracji

Do płatności kartą Tritius korzysta z usług bramki płatniczej Comgatelub GoPay.

Biblioteka zawiera umowę bezpośrednio z dostawcą wybranej bramki.

Moduł bramki płatniczej w katalogu systemu Tritius jest płatny zgodnie z cennikiem, w tym późniejsze aktualizacje.

Biblioteka ma dostęp do interfejsu internetowego, gdzie może przeglądać rozliczenia i wyświetlać szczegóły płatności.

Opłata za przedłużenie rejestracji

  • Przedłużenie rejestracji za pośrednictwem katalogu musi być dozwolone przez ustawienie: CATALOG_REGISTRATION_PROLONGATION_ENABLED
    • Przed wygaśnięciem rejestracji w katalogu czytelnik otrzyma powiadomienie o jej wygaśnięciu.
  • Termin wyświetlenia powiadomienia można skorygować poprzez ustawienie: CATALOG_REGISTRATION_PROLONGATION_PERIOD
    • Po kliknięciu na powiadomienie o wygasającej rejestracji wyświetli się strona z listą wygasających rejestracji.
    • Może być więcej rejestracji w różnych działach.
    • Czytelnik może przedłużyć poszczególne rejestracje, klikając przycisk „Przedłuż rejestrację”.
      • Po kliknięciu przycisku „Przedłuż rejestrację” czytelnikowi wyświetli się strona z podsumowaniem informacji:
      • Od kiedy nowa rejestracja będzie ważna.
      • Do kiedy nowa rejestracja będzie ważna.
      • W jakich działach rejestracja będzie ważna (w tym w działach powiązanych).
      • Pole wyboru potwierdzające, że czytelnik zgadza się z regulaminem biblioteki (ewentualnie link do regulaminu biblioteki).
      • Na końcu strony dostępne będą dwie opcje:
        • Potwierdź i zapłać – wyświetli się płatność kartą, czytelnik dokona płatności, a rejestracja będzie w pełni ważna.
        • 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.
  • Po pierwszym przyjściu do biblioteki po przedłużeniu za pomocą karty bibliotekarzowi wyświetlą się informacje (aby mógł sprawdzić dane).
  • Listę aktywnych rejestracji czytelnik może również wyświetlić w menu użytkownika pod linkiem „Moje rejestracje”.

Płatność za zaległe opłaty

  • W menu czytelnika wyświetlana jest całkowita kwota zadłużenia czytelnika.
  • W menu czytelnika, pod linkiem „Moje opłaty”, wyświetlana jest również kwota aktualnie należnych opłat.
  • Po kliknięciu na całkowitą kwotę wyświetla się lista należnych opłat.
  • 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.
  • Katalog zawiera ustawienie PAYMENT_GATE_MINIMAL_AMOUNT określające minimalną kwotę, jaką można zapłacić za pomocą bramki płatniczej.

Brama płatnicza GoPay

Warunki GoPay

Firma GoPay nie ma już niestety wspólnych warunków umownych dla bibliotek.

Warunki umowne są teraz ustalane indywidualnie z każdą biblioteką, a na podstawie osiągniętego obrotu można uzgodnić korzystniejsze warunki.

Poniższa tabela przedstawia orientacyjne ceny podane przez dział handlowy firmy GoPay w sierpniu 2019 r.:

Miesięczny obrót (w CZK)rabat z przenoszonej kwotyryczałtowa kwota za transakcję
do obrotu 8 700 PLN2,2 % od kwoty+ 0,5 PLN
8 700  - 17 500 PLN1,7 % od kwoty+ 0,5 PLN

Rejestracja w GoPay

Najpierw należy zarejestrować się w firmie GoPay, korzystając z poniższego linku:

https://registration.gopay.com/cs/signup-supplier/tritius
 

Poniżej znajduje się formularz, w którym należy podać między innymi następujące dane:

1722590771235-512.png

W tym miejscu należy podać adres własnego katalogu internetowego (najczęściej: <nazwa biblioteki>.tritius.cz).

Nie należy zaznaczać pola, ponieważ strona internetowa jest publicznie dostępna.

Będziesz sprzedawać:  rejestrację i spłatę zadłużenia czytelników

Konfiguracja bramki w Tritiu

Korzystanie z bramki płatniczej w katalogu należy włączyć i skonfigurować.

Klucz

Typ

Opis

CATALOG_SHOW_TERMS_AND_CONDITIONS_PAGEBooleanZezwolenie na wyświetlenie strony z warunkami płatności
CATALOG_SHOW_PRICE_LIST_PAGEBooleanZezwól na wyświetlenie strony z cennikiem
CATALOG_CARD_PAYMENT_ENABLEDBooleanZezwolenie na płatności kartą w katalogu
CATALOG_REGISTRATION_PROLONGATION_ENABLEDBooleanZezwolenie na przedłużenie rejestracji
CATALOG_REGISTRATION_PROLONGATION_PERIODIntLiczba dni do końca rejestracji, od kiedy można ją przedłużyć. Domyślnie jest to 31 dni.
IS_ENABLED_TO_PROLONG_EXPIRED_REGISTRATIONSBooleanZezwolenie na przedłużenie wygasłej rejestracji w katalogu.
GOPAY_URLString

Adres URL bramki GoPay.

https://gate.gopay.cz/api/
GOPAY_IDString

Identyfikator klienta GoPay.

Otrzymasz po podpisaniu umowy z GoPay.

GOPAY_CLIENT_IDString

Numer klienta GoPay dla API.

Otrzymasz po podpisaniu umowy z GoPay.

GOPAY_SECRET_KEYString

Hasło GoPay do API.

Otrzymasz po podpisaniu umowy z GoPay.

PAYMENT_GATE_MINIMAL_AMOUNT IntMinimalna kwota, jaką można zapłacić za pośrednictwem bramki. Domyślnie 10 CZK.
CATALOG_ENABLE_PAYMENTSBoolean

Zezwolenie na płatności w katalogu. Domyślnie włączone. Można ustawić dla poszczególnych użytkowników.

Odpowiednie np. do zezwolenia jednemu użytkownikowi na testowanie bramki płatniczej.

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

Podczas edycji szablonu HTML należy zachować domyślną strukturę tagów i wpisać własny tekst między te tagi.

Inspiracją mogą służyć biblioteki, które już sporządziły warunki handlowe:
 

Brama płatnicza Comgate

Web: https://www.comgate.cz/cz

Aktualny cennik: https://www.comgate.cz/cz/cena
Portal klienta: https://portal.comgate.cz/cs/site/index
Dokumentacja: https://portal.comgate.cz/cs/dokumentace

Zawarcie umowy: https://help.comgate.cz/docs/smlouva-online

Artykuły:

Warunki płatności

Opłaty jednorazowe

Ustanowienie bramki płatniczej0,-
Codzienne przelewy pieniędzy na konto bankowe klienta0,-
EET w bramce płatniczej0,-
Anulowanie bramki płatniczej0,-
Zwrot pieniędzy (zwrot środków pieniężnych płatnikowi na wniosek klienta)2 Kč
Chargeback (przymusowy zwrot środków pieniężnych płatnikowi na podstawie skargi płatnika)990 Kč

Miesięczne opłaty za zarządzanie i procentowe opłaty od transakcji

Miesięczny wolumen transakcjido 100.000 kč/měsíc100.000-500.000 kč/měsíc500.000kč-3 mil Kč/měsíc
Opłata miesięczna149 Kč99 Kč0 Kč
Opłata transakcyjna0,99% + 0,- Kč0,89% + 0,- Kč0,79% + 0,- Kč

Stałe opłaty transakcyjne

Płatności kartą0 Kč
Przyciski płatnicze w Czechach0 Kč
Przyciski płatnicze na Słowacji0,2 EUR

Konfiguracja bramki w Tritiu

Korzystanie z bramki płatniczej w katalogu należy włączyć i skonfigurować.

Klucz

Typ

Opis

CATALOG_SHOW_TERMS_AND_CONDITIONS_PAGEBooleanZezwolenie na wyświetlenie strony z warunkami płatności
CATALOG_SHOW_PRICE_LIST_PAGEBooleanZezwól na wyświetlenie strony z cennikiem
CATALOG_CARD_PAYMENT_ENABLEDBooleanZezwolenie na płatności kartą w katalogu
CATALOG_REGISTRATION_PROLONGATION_ENABLEDBooleanZezwolenie na przedłużenie rejestracji
CATALOG_REGISTRATION_PROLONGATION_PERIODIntLiczba dni do końca rejestracji, od kiedy można przedłużyć rejestrację. Domyślnie jest to 31 dni.

IS_ENABLED_TO_PROLONG_EXPIRED_REGISTRATIONS

BooleanZezwolenie na przedłużenie wygasłej rejestracji w katalogu
COMGATE_MERCHANTString

Identyfikator klienta Comgate

Otrzymasz po podpisaniu umowy z Comgate.

COMGATE_SECRETString

Hasło

Otrzymasz po podpisaniu umowy z Comgate.

COMGATE_TESTBooleanOznaczenie trybu testowego. Konieczny jest dostęp do trybu testowego Comgate.
PAYMENT_GATE_MINIMAL_AMOUNTIntMinimalna kwota, jaką można zapłacić za pośrednictwem bramki. Domyślnie 10 CZK.
CATALOG_ENABLE_PAYMENTSBoolean

Zezwolenie na płatności w katalogu. Domyślnie włączone. Można ustawić dla poszczególnych użytkowników.

Przydatne np. do zezwolenia jednemu użytkownikowi na testowanie bramki płatniczej.

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

Podczas edycji szablonu HTML należy zachować domyślną strukturę tagów i wpisać własny tekst pomiędzy tymi tagami.

Konfiguracja bramy w Comgate

W ustawieniach bramki płatniczej Comgate należy skonfigurować adresy UR tak, aby kierowały do Tritius. Menu główne → Integracja → Ustawienia sklepów.

Dokumentacja Comgate: https://help.comgate.cz/docs/navod-k-pouziti#propojen%C3%AD-obchodu

ParametrWartość
URL opłaconyhttps://x.tritius.cz/comgate/paid?id=${id}&refId=${refId}
URL usuniętyhttps://x.tritius.cz/comgate/canceled?id=${id}&refId=${refId}
URL nieprzetworzonyhttps://x.tritius.cz/comgate/pending?id=${id}&refId=${refId}
URL do przekazania wyniku płatnościhttps://x.tritius.cz/comgate/status
Dozwolone adresy IPAdres IP VM lub proxy.

Referencje

  • 07/2020 - Severočeská vědecká knihovna Ústí nad Labem (Comgate)
  • 08/2020 - Knihovna Města Ostravy  (Comgate)
  • 09/2020 - Městská knihovna Třinec  (Comgate)
  • 10/2020 - Městská knihovna Klatovy (GoPay)
  • 03/2021 - Městská knihovna Hodonín (Comgate)
  • 04/2021 - Městská knihovna Jindřichův Hradec (Comgate)
  • 05/2021 - Městská knihovna Jihlava (Comgate)