Platby

Jak u plateb zobrazit platební údaje (QR, VS, SS,..)

Pro zobrazení platebních údajů na kartě člena je potřeba napřed nastavit v organizaci informace o bance.

  • V uživatelském menu v pravo nahoře otevřete položku Moje organizace.

  • Klikněte na tlačítko Upravit organizaci.

  • Na záložce Bankovní účty přidejte nový účet kliknutím na +.

  • Po vyplnění údajů klikněte na tlačítko Uložit organizaci.

Bankovní účet musí být nastaven jako Hlavní.

Pro generování QR kódu v emailech o platbě musí být číslo účtu validní!

TŠCH - mají 2 organizace - TŠCH a SPP, každá z nich má vlastní IČO a vlastní bankovní účet, také vlastní smlouvu na comgate.

Uživatelé i pohledávky jsou vedeny v jedné organizaci (TŠCH), párování plateb provádí přes csv, kde nahrají dva soubory csv, každý z jednoho účtu.

Pokud by chtěli automatické párování, přidal by se do TŠCH druhý účet (SPP) a při automatickém párování by se procházely oba tyto účty.

Při registraci na událost TŠCH se vygeneruje pohledávka a následuje Výzva k platbě TŠCH na účet TŠCH na comgate1.

Při registraci na událost SPP se vygeneruje pohledávka, ale výzva k platbě je vypnutá. Odesílá se ručně přes speciální šablonu obsahující extra vložené idéčko bankInfromation Výzva k platbě SPP na comgate2.

Jak se generuje variabilní a specifický symbol

Standardní platby v IS

Výchozí hodnoty platebních symbolů se ukládají do settingu crm-payment-symbols-format-other. Rozdělení na variablilní a specifický symbol je v pořadí VS|SS, např. MEMBER_NUMBER|SERVICE_NUMBER.

Tabulka 1. Předdefinované platební symboly plateb
Formát Popis

MEMBER_NUMBER

Členské číslo

BIRTH_NUMBER

Rodné číslo

SERVICE_NUMBER

Symbol ze služby; v GUI se vybírá z vybraných služeb; automaticky se vybírá symbol ze služby podle nejvyšší ceny, napřed se projdou služby ve členství a pak ostatní služby.

IDENTIFICATION_NUMBER

Identifikační číslo instituce

OWN

Zadání vlastního symbolu; v GUI lze zadat vlastní hodnotu

DEFINED_XXX

Předdefinovaná hodnota XXX, např. DEFINED_68408010 → 68408010

SEQUENCE_XXX

Posloupnost s prefixem XXX, např. SEQUENCE_1 → 1xxxxxxxxx, najde nejvyšší a zvýší o jedna mimo událostní platby

DEFINED_XXX a SEQUENCE_XXX se musí napřed vložit jako organizační hodnota číselníku definice PAYMENT_SYMBOLS_TEMPLATES_OTHER. Pak se může vložit do settingu crm-payment-symbols-format-other.

Pak se budou tyto formáty zobrazovat i mezi možnostmi výběru generování symbolu v dialogovém okně platby.

Platby za událost

Výchozí hodnoty platebních symbolů se ukládají v Možnostech platby na záložce Ceník v definici události. Vždy se nastavuje EVENT_DATE_PREFIX.

Tabulka 2. Předdefinované platební symboly plateb za událost
Formát Popis

EVENT_DATE_PREFIX

Prefix datum události: V případě celodenní události se prefix vytvoří z data začátku události ve formátu "MMdd" v případě události začínající v nějakou hodinu se prefix vytvoří z data začátku události ve formátu "MMddHH". Zbytek čísla se generuje náhodně a kontroluje se duplicita celého čísla

EVENT_DEFINED_XXX

Předdefinovaná hodnota XXX, např. DEFINED_68408010 → 68408010 pro události

EVENT_GLOBAL_SEQUENCE_XXX

Posloupnost s prefixem XXX, např. EVENT_GLOBAL_SEQUENCE_2024 → 2024xxxxxx, najde nejvyšší a zvýší o jedna u všech událostních plateb

EVENT_SEQUENCE_XXX

Posloupnost s prefixem XXX, např. EVENT_SEQUENCE_2024 → 2024xxxxxx, najde nejvyšší a zvýší o jedna u plateb v konkrétní události

EVENT_DEFINED_XXX, EVENT_GLOBAL_SEQUENCE_XXX a EVENT_SEQUENCE_XXX se musí napřed vložit jako organizační hodnota číselníku definice PAYMENT_SYMBOLS_TEMPLATES_EVENT.

Pak se budou tyto formáty zobrazovat i mezi možnostmi výběru generování symbolu v definici události a dialogovém okně platby.

Jak se nastavuje výchozí datum splatnosti

Standardní platby v IS

Výchozí hodnota splatnosti se ukládá do settingu crm-default-payment-due.

Možnosti nastavení splatnosti:

  • dd.MM. - konkrétní datum v roce, např. 31.3. (rok se doplní automaticky podle toho, zda den v roce již uplynul).

  • počet dní - připočte se počet dní od data zadání platby, např. 30 (měsíc).

Další možností je použít Splátkový kalendář.

Platby za událost

Výchozí hodnota splatnosti se ukládá do settingu crm-default-event-payment-due.

Možnosti nastavení splatnosti:

  • počet dní - připočte se počet dní od začátku události. Hodnota může být záporná, např. -3 (3 dny před začátkem).

Další možností je používat Splátkový kalendář v nastavení ceníku událostí.

Jak se nastavuje výchozí forma úhrady

Výchozí hodnota formy úhrady se ukládá do settingu crm-default-payment-type. Tato hodnota se bude vyplňovat při práci s platbami uživatelem v Manažerské sekci IS.

  • Výchozí hodnota je Hotově.

Jak se nastavuje Párování plateb z banky

Zobrazení/skrytí párování plateb se provádí přes setting crm-show-payment-matching. Ve výchozím nastavení je párování plateb dostupné v Manažerská sekce → Ekonomika → Párování plateb.

Nastavení sktruktury úhrad z banky

Každá banka má svůj CSV formát pro export úhrad. Proto je potřeba pro každou banku vytvořit rozhraní, které bude importovat exportovaná data do příslušných sloupců v systémů.

Z banky je potřeba získaz aktuální seznam úhrad za dané období. Nikoliv výpis z účtu, který se generuje až v následujícím měsíci.

CSV formát exportované sestavy se nastavuje přes setting crm-payment-matching-banks.

Organizace může používat úhrady z více bank. V settingu se oddělují znakem "|".
Tabulka 3. Dostupné CSV formáty exportovaných sestav z banky
Banka UUID Export musí obsahovat sloupce

Fio banka

FIO_BANK

ID operace;Číslo účtu;Datum;Objem;Měna;VS;SS;KS;Zpráva pro příjemce;Poznámka;Protiúčet;Kód banky

Fio banka SK

FIO_SK_BANK

ID operácie;Číslo účtu;Dátum;Objem;Mena;VS;SS;KS;Správa pre príjemcu;Poznámka;Protiúčet;Názov protiúčtu;Kód banky

Raiffeisenbank

RAIFFEISEN_BANK

Id transakce;Číslo účtu;Datum provedení;Zaúčtovaná částka;Měna účtu;VS;SS;KS;Poznámka;Název protiúčtu;Číslo protiúčtu

Česká spořitelna (George)

CS_GEORGE_BANK

ID transakce;Datum zaúčtování;Částka;Měna;Variabilní symbol;Specifický symbol;Konstantní symbol;Zpráva pro příjemce;Poznámka;Protiúčet

Česká spořitelna (Finance 24)

CS_FINANCE_24_BANK

Bankovní reference;Datum zpracování;Částka (transakce);Variabilní symbol 1;Specifický symbol;Konstantní symbol;Zpráva pro příjemce;Název protiúčtu;Předčíslí účtu plátce/příjemce;Číslo účtu plátce/příjemce;Kód banky plátce/příjemce

Tatra banka

TATRA_BANK

Referencia platby;Dátum zúčtovania;Suma;Mena;Číslo účtu / IBAN;Variabilný symbol;Konštantný symbol;Špecifický symbol;Informácia pre príjemcu;Popis transakcie;Typ platby

Komerční banka

KB_BANK

Identifikace transakce;Datum splatnosti;Částka;VS;KS;SS;Název protiúčtu;Protiúčet a kód banky;AV pole 1;AV pole 2;AV pole 3;AV pole 4

AirBank

AIR_BANK

Referenční číslo;Datum provedení;Částka v měně účtu;Měna účtu;Variabilní symbol;Konstantní symbol;Specifický symbol;Zpráva pro příjemce;Poznámka k úhradě;Číslo účtu protistrany;Název protistrany

Příklad obsahu .csv souboru pro nahrání plateb

Soubor může mít libovolné jméno a příponu .csv. V prvním řádku je vždy hlavička s požadovanýma sloupcema.

Raiffeisenbank
Datum provedení;Číslo účtu;Číslo protiúčtu;Název protiúčtu;Poznámka;VS;KS;SS;Zaúčtovaná částka;Id transakce(1)
23.09.2021;1956310227/5500;43-8416450247/0100; Arencibia Lucie;Text poznámky;0927191482;;;2900,00;5006(1)
1 Unikátní ID transakce - pokud je transakce se stejným ID už nahrána bude přeskočeno

Nastavení formy úhrady po spárování platby

Výchozí hodnota formy úhrady po spárování platby se ukládá do settingu crm-default-payment-matching-type. Tato hodnota se bude vyplňovat automaticky po spárování platby.

  • Výchozí hodnota je Převodem.

Vyřazení účtů příchozích úhrad z párování plateb

Seznam účtů, které se automaticky nastaví jako "vyřazené" při nahrávaní CSV souboru z banky. Čísla účtů se nastastavují v settingu crm-account-statement-black-list a oddělují se znakem "|".

Používá se převážně u účtů, které nesouvisí s párováním. Jedním příkladem je příchozí úhrada z účtu ComGate, kde se posílají úhrady z platební brány.

Jak se nastavuje automatické stahování plateb z banky přes API

V tuto chvíli lze nastavit automatické stahování přes API z Fio Banky nebo Tatra Banky. Po stažení úhrad se provede i automatické spárování platby. Pro automatické stažení a párování je potřeba by aby číslo účtu v BankInformation odpovídalo číslu účtu v datech získaných z API (v případě TatraBanky se porovnáva IBAN).

Automatické načítání plateb z FioBanky

Než se nastaví API v IS, je potřeba vytvořit v internetovém bankovnictví token pro přístup k api.

  • Přihlašte se do internetového bankovnictví Fio Banky.

  • V pravém horním rohu klikněte na Nastavení.

  • V menu nastavení vyberte položku API.

  • Na stránce vyberte účet, pro který se má vytvořit přístupový token.

  • Kód vytvořeného tokenu zkopírujte.

Nastavení v PI

Token z Fio Banky se nastavuje přes databázi.

  • V datazi najděte tabulku s bankovními účty organizace PI_OU_BankInformation.

  • K vybranému účtu zadejte hodnotu API Token do sloupce apiAccountKey.

Automatické načítání plateb z TatraBanky

Párovaní s TatraBankou máme implementované v režimu Final Api Consumer (FAC). Takže smlouva s TatraBankou uzavírá konkrétní organizace. Smlouva se uzavírá až při přechodu do produkce. Pro párování plateb využíváme službu Premium API - Accounts. Po níže popsaném nastavení a povolení automatického načítání plateb musí organizace co 90 dnů provádět autorizace (skrze tlačítko TatraBank autorizace v Ekonomika → Párování plateb).

Pokyny pro organizaci

Nastavení aplikace na developer.tatrabanka.sk

Údaje API Key / Client ID a Shared secret / Client se použijou pro konfiguraci PI

Nastavení v PI

Automatické načítání plateb z České spořitelny

Nastavení v PI

Nastavení na/podle erste portál

https://developers.erstegroup.com/portal/organizations/vrk-plus/applications/4a7e9dfa-1935-424c-985e-c03a513c5ee5/banks/bank.csas/detail

Povolení automatického načítání plateb přes API

Po provedeních předchozích krok (jak pro FIO tak TatraBanku) je potřeba nastavit spuštění načítání:

Stahování z banky probíhá 2x denně (0 30 1,13 * * ? *). Do settingu crm-payments-api-load-last-date se uloží poslední datum, kdy se stáhly naposledy platby.

Jak nastavit Transparentní účet

Pokud chce organizace umožnit členům nahlížet na pohyby na účtu, existuje portlet crm-account-statement-view, který se vloží do členské sekce IS a členové se tak mohou dívat na platby jako u transparentního účtu. Nahlížení na pohyby se musí ještě nastavit přes setting crm-payments-open-account-statement, kde se k organizaci nastaví hodnota TRUE.

Jak se nastavuje Platební brána

Platební brána je poskytovaná firmou ComGate. Po uhrazení platby kartou dojde ke spárování úhrady s placenou pohledávkou, jakmile platební brána pošle zpět informaci, že došlo k úspěšné transakci.

Inicializace

Zákazník kontaktuje sám Comgate, že používá IS PI a že by chtěl používat platební bránu. Uvede také kontakt podpora@pohodlne.info jako technický správce.

Comgate po zákazníkovi obvykle chce, aby měl připravenou v p.i stránku organizace doplněnou o kecy kolem plateb a odkazy na všeobecné a reklamační podmínky na jeho vlastních stránkách. Je třeba tam mít i ukázku rekapitulační stránky po platbě.

https://help.comgate.cz/docs/loga-a-udaje-na-webu

Příklad 1. Ukázky keců
https://is.pohodlne.info/organizace/detail/154066
https://is.retriever-klub.cz/organizace/detail/232668
https://is.aikikai.sk/organizace/detail/361466

Předmět: Zavedení platební brány Comgate v IS pohodlne.info

Dobrý den,

pro zavedení platební brány pro vaši organizaci v IS pohodlne.info je potřeba z vaší strany kontaktovat přímo společnost Comgate, že máte zájem používat jejich platební bránu v našem Informačním systému pohodlne.info a uveďte prosím kontakt na podpora@pohodlne.info jakožto technického správce IS, který provede příslušná nastavení.

Comgate požaduje upravení popisu Moje organizace v IS o informace k používání platební brány a také umístění log na vaše webové stránky viz. https://help.comgate.cz/docs/loga-a-udaje-na-webu. Můžete se inspirovat popisem např. na https://is.retriever-klub.cz/organizace/detail/232668.

Jakmile budou splněny podmínky pro zprovoznění platební brány Comgate, obdržíte návrh smlouvy. Poté obdržíte také přístup do Klientského portálu Comgate, kde je potřeba z naší strany provést nastavení propojení platební brány s IS. Proto nás poté kontaktujte a domluvíme se na finálním nastavení a zprovoznění platební brány v IS.

Test ze strany Comgate

Obvykle chtěli přístup do testovací aplikace, aby viděli jak bude platba probíhat.

Příklad 2. Ukázka e-mailu

Dobrý den, na základě dnešního telefonického rozhovoru zasílám přístup do testovací aplikace pro Retriever klub CZ.

Typicky člen platí třemi způsoby:

  1. Přihlásí se do členské sekce, tam na kartě člena zvolí záložku "Platby", zde má seznam neuhrazených pohledávek. Po kliknutí na tlačítko QR kódu se mu zobrazí možnosti platby vč. odkazu na platební bránu.

    Obrázek na platby v Kartě člena

  2. Do mailové schránky člena přijde výzva k platbě, kde jsou uvedené pokyny vč. odkazu na platební bránu. Náhled takového mailu je vidět na Kartě člena v záložce "Ostaní" položka "Výzva k platbě".

    Obrázek na e-mail Výzva k platbě

  3. Pokud se člen registruje na událost v rámci rekapitulace jsou mu zobrazeny obdobné platební pokyny.

Testovací verze běží na adrese https://is-rkcz.vrk.cz, uživatel: makal@vrk.cz, heslo: comgate.21

V případě nejasností mě kontaktujte, děkuji.

Návrh smlouvy

Pokud zákazník projde, dostane návrh smlouvy od Comgate k podpisu.

Nastavení v portálu ComGate

Než se nastaví platební brána v IS, je potřeba vytvořit v portálu ComGate přístup k platební bráně.

  • Přihlašte se do portálu ComGate.

  • Zobrazte si stránku Portal ComGate → Integrace → Nastavení obchodu → Propojení obchodu.

  • Získejte ze stránky Identifikátor propojení obchodu a nastavte Heslo.

Další pole nastavte následovně:

  • URL zaplacený:

    https://is.vasedomena.cz/platebni-brana/platba/${id}/PAID?refId=${refId}

  • URL zrušený:

    https://is.vasedomena.cz/platebni-brana/platba/${id}/CANCEL?refId=${refId}

  • URL nevyřízený:

    https://is.vasedomena.cz/platebni-brana/platba/${id}/PENDING?refId=${refId}

  • URL předání výsledku:

    https://is.vasedomena.cz/pi-crm-portlet/paymentGateway

  • Povolená IP adresa:

    35.206.191.230 - Ostrá
35.210.190.107 - Test

Nastavení v IS

Hodnoty z ComGate se nastavují přes databázi.

  • V datazi najděte tabulku s bankovními účty organizace.

  • K vybranému účtu zadejte hodnoty Identifikátor propojení obchodu → merchant a Heslo → secret.

Pokud organizace používá i párování plateb, doporučuje se vyřadit číslo účtu portálu ComGate, ze kterého budou chodit platby po zaplacení přes platební branu.

Povolení používání platební brány

Pokud je u bankovního účtu organizace nastaven Identifikátor propojení obchodu, bude platební brána k dispozici v testovacím módu. Pro přepnutí platební brány do ostrého provozu je potřena nastavit setting crm-payment-gateway u organizace na hodnotu FALSE.

V případě použití platební brány pro prezentace (DEMO) je potřeba nastavit na testu Identifikátor propojení obchodu a Heslo podle ostatních organizací z testu.

Nastavení formy úhrady po zaplacení přes bránu

Výchozí hodnota formy úhrady po zaplacení přes platební bránu se ukládá do settingu crm-default-payment-gateway-type. Tato hodnota se bude vyplňovat automaticky po vrácení informace z platební brány, že platba byla uhrazena.

  • Výchozí hodnota je Platební bránou.

V případě použití platební brány nezapomenout nastavit hodnotu do Administrace → Číselníky → Forma úhrady v manažerské sekci.

Další nastavení plateb

Nastavení zadávání pohledávek u platby

Zobrazení ekonomiky se zadáváním pohledávek, se nastavuje přes setting CRM_EXT_POHLEDAVKY. Ve výchozím nastavení jsou platby s pohledávkami povoleny.

V případě, že zákazník zadává jen úhrady, nastaví se u organizace hodnota settingu na FALSE. Nebude tak k dispozici datum splatnosti a cena k uhrazení. Nepůjde generovat pohledávky.

V případě, že zákazník přidává jen uhrady, nelze použít další nástroje pro práci s platbami, jako je Párování plateb nebo Platební brána.

Nastavení zadávání uhrazených měsíců

V případě, že klub používá měsíční platby a chce evidovat, jaké měsíce člen zaplatil a sledovat tak měsíční přehled, nastaví se setting CRM_SHOW_PAYMENTS_MONTHS u organizace na hodnotu TRUE.

U zadávání plateb se zobrazí tabulka s výběrem měsíce v roce a v Ekonomika → Měsíční platby se zobrazí přehled členů o zaplaceném poplatku na dané měsíce.