Tento článek nabízí univerzální krok za krokem postup pro napojení jakékoli podporované banky nebo platební brány v GoodEshop. Díky této integraci budete moci automatizovaně párovat platby s objednávkami, spouštět workflow a minimalizovat chybovost díky notifikacím o pohybech a importu transakcí.
- Rozhodněte se, zda chcete napojit běžný bankovní účet (např. Tatra banka, FIO, VÚB...) nebo online platební bránu (GoPay, Stripe, Mollie, Besteron…).
- Pro banky si připravte přístup do svého internetového bankovnictví a nastavte možnost odesílání notifikačních emailů o přijatých platbách.
- U platebních bran si připravte autentifikační údaje (API klíč, secret key, client id, client secret, CID, identifikátor obchodu, případně email/notifikaci o pohybu).
- Ověřte, že máte aktivní účet a povolené API/notifikační služby podle dokumentace banky/brány nebo požadavků daného poskytovatele.
- V GoodEshop přejděte do sekce Banka.
- Vyberte svou banku ze seznamu.
- GoodEshop vám vygeneruje unikátní notifikační email ve formátu
bmail-{HASH}@goodeshop.io.
- Tento email vložte do svého internetového bankovnictví jako notifikační email pro platby/příjmy.
- Uložte nastavení v bance, proveďte testovací platbu a zkontrolujte, zda GoodEshop přijal notifikaci a správně spároval platbu s objednávkou.
- V GoodEshop přejděte do sekce Banka.
- Klikněte na logo požadované platební brány (např. Stripe, GoPay, Besteron...).
- Zadejte požadované údaje podle typu brány (Secret key, API klíč, Client ID, Client Secret, CID...).
- Uložte nastavení.
- Systém automaticky otestuje ověření spojení a aktivní připojení; v případě nesprávného údaje zobrazí chybové hlášení.
- Specifikujte párovací pole (podle čeho bude platba přiřazována k objednávce – číslo objednávky, variabilní symbol, faktura...).
- Po aktivaci banky/brány nastavte pravidla párování:
- Priorita: 1. variabilní symbol, 2. číslo faktury, 3. číslo objednávky (doporučený postup)
- Určete, která pole mají být priorizována podle toho, jak je vaše banka nebo brána posílá v notifikaci nebo webhooku
- Pro unikátní scénáře (např. marketplace s více eshopy) je možné nastavit individuální párování pro každý kanál.
- Po spuštění/zapojení notifikace/brány proveďte testovací platbu nebo refundaci a sledujte, zda se v GoodEshop zobrazí přijatá platba a správně spáruje s odpovídající objednávkou.
- Zkontrolujte, že workflow (např. automatická fakturace, změna stavu objednávky, notifikace zákazníkovi) funguje podle nastavených pravidel.
- Nechodí notifikace z banky: Zkontrolujte, zda jste správně zadali notifikační email v bankovnictví a banka službu podporuje.
- Platba není párována: Podívejte se, jaký údaj platba obdržela (VS, objednávka, faktura) a upravte prioritu párovacích polí.
- Nesprávné/neplatné autentifikační údaje: Ověřte přímo v rozhraní brány/banky, zda zadáváte aktuální klíč/secret; v případě potřeby vygenerujte nový.
- Více bankovních účtů/brán: Pro každý účet použijte samostatné napojení v GoodEshop.
- Citlivé údaje (API klíče, Secret keys) nikdy nesdílejte mimo GoodEshop nebo důvěryhodné aplikace.
- Po změně nebo smazání údajů v rozhraní banky/brány je neprodleně aktualizujte v GoodEshop.
Univerzální návod vám umožní napojit téměř jakoukoli banku nebo platební bránu v GoodEshop, propojit finanční toky s objednávkami bez ruční práce a nastavit efektivní workflow pro fakturaci, expedici i reporting.