Tento článok ponúka univerzálny krok za krokom postup pre napojenie akejkoľvek podporovanej banky alebo platobnej brány v GoodEshop. Vďaka tejto integrácii budete môcť automatizovane párovať platby s objednávkami, spúšťať workflow a minimalizovať chybovosť vďaka notifikáciám o pohyboch a importu transakcií.
- Rozhodnite sa, či chcete napojiť bežný bankový účet (napr. Tatra banka, FIO, VÚB...) alebo online platobnú bránu (GoPay, Stripe, Mollie, Besteron…).
- Pre banky si pripravte prístup do svojho internet bankingu a nastavte si možnosť odosielania notifikačných emailov o prijatých platbách.
- Pri platobných bránach si pripravte autentifikačné údaje (API kľúč, secret key, client id, client secret, CID, identifikátor obchodu, prípadne email/notifikáciu na pohyb).
- Overte, že máte aktívny účet a povolené API/notifikačné služby podľa dokumentácie banky/brány alebo podľa požiadaviek daného poskytovateľa.
- V GoodEshop prejdite do sekcie Banka.
- Vyberte svoju banku zo zoznamu.
- GoodEshop vám vygeneruje unikátny notifikačný email vo formáte
bmail-{HASH}@goodeshop.io.
- Tento email vložte do svojho internet bankingu ako notifikačný email pre platby/príjmy.
- Uložte nastavenia v banke, vykonajte testovaciu platbu a skontrolujte, či GoodEshop prijal notifikáciu a správne spároval platbu s objednávkou.
- V GoodEshop prejdite do sekcie Banka.
- Kliknite na logo požadovanej platobnej brány (napr. Stripe, GoPay, Besteron...).
- Zadajte požadované údaje podľa typu brány (Secret key, API kľúč, Client ID, Client Secret, CID...).
- Uložte nastavenia.
- Systém automaticky otestuje overenie spojenia a aktívne pripojenie; v prípade nesprávneho údaja zobrazí chybové hlásenie.
- Špecifikujte párovacie pole (podľa čoho bude platba priraďovaná k objednávke – číslo objednávky, variabilný symbol, faktúra...).
- Po aktivácii banky/brány nastavte pravidlá párovania:
- Priorita: 1. variabilný symbol, 2. číslo faktúry, 3. číslo objednávky (odporúčaný postup)
- Určte, ktoré polia majú byť priorizované podľa toho, ako ich vaša banka alebo brána posiela v notifikácii alebo webhooku
- Pre unikátne scenáre (napr. marketplace s viacerými eshopmi) je možné nastaviť individuálne párovanie pre každý kanál.
- Po spustení/zapojení notifikácie/brány vykonajte testovaciu platbu alebo refundáciu a sledujte, či sa v GoodEshop zobrazí prijatá platba a správne spáruje s odpovedajúcou objednávkou.
- Skontrolujte, že workflow (napr. automatická fakturácia, zmena stavu objednávky, notifikácia zákazníka) funguje podľa nastavených pravidiel.
- Neprichádzajú notifikácie z banky: Skontrolujte, či ste správne zadali notifikačný email v bankingu a banka službu podporuje.
- Platba nie je párovaná: Pozrite, aký údaj dostala platba (VS, objednávka, faktúra) a upravte prioritu párovacích polí.
- Nesprávne/neplatné autentifikačné údaje: Overte priamo v rozhraní brány/banky, či zadávate aktuálny kľúč/secret; v prípade potreby vygenerujte nový.
- Viac bankových účtov/brán: Pre každý účet použite samostatné napojenie v GoodEshop.
- Citlivé údaje (API kľúče, Secret keys) nikdy nesdieľajte mimo GoodEshop alebo dôveryhodných aplikácií.
- Po zmene alebo vymazaní údajov v rozhraní banky/brány ich neodkladne aktualizujte v GoodEshop.
Univerzálny návod vám umožní napojiť takmer akúkoľvek banku alebo platobnú bránu v GoodEshop, spojiť finančné toky s objednávkami bez ručnej práce a nastaviť efektívny workflow pre fakturáciu, expedíciu i reporting.