Nastavení Checkoutu

Ověřte schválení obchodníka a spravujte návratové cíle, peněženky, branding a klíče Checkoutu v Tapaya Platform.

V Tapaya Platform otevřete Checkout. Stránka zobrazuje Organization defaults (výchozí nastavení organizace) a seznam Checkout merchants (obchodníci Checkoutu) vaší organizace. Výběrem obchodníka otevřete stránku jeho nastavení. Obchodníka zde nakonfigurujte dříve, než integrujete Hosted Checkout nebo Embedded Checkout.

Co jednotlivé integrace potřebují

Projděte nastavení, která vaše integrace používá, odshora dolů:

Nastavení	Hosted Checkout	Embedded Checkout
Onboarding obchodníka až do stavu Ready	Povinné	Povinné
Checkout klíče obchodníka	Režim obchodníka	Režim obchodníka
Návratové cíle	Povinné	Nepoužívá se
Název zobrazovaný zákazníkům	Volitelné	Volitelné
Peněženky a vzhled	Volitelné	Volitelné
Domény obchodu pro Apple Pay	Nepoužívá se	Pro Apple Pay

Režim platformy místo Checkout klíče obchodníka používá Secret key organizace ze stránky API Keys.

Onboarding obchodníka pro Checkout

Dokončete onboarding obchodníka se zvolenými online platbami, případně s online platbami i platbami v prodejně. Online onboarding shromažďuje web obchodu a údaje o online podnikání. Obchodník, který používá pouze Checkout, nepotřebuje terminály.

Obchodníci, kteří žádají o online platby, se automaticky zobrazují v seznamu Checkout merchants, včetně těch, kteří čekají na schválení. Vytvoření záznamu obchodníka ani Checkout klíče neznamená schválení online plateb. Samotné schválení plateb v prodejně Checkout nezpřístupní.

Tabulka zobrazuje připravenost obchodníka:

Stav	Význam	Další krok
Merchant inactive	Účet obchodníka je neaktivní.	Před přijímáním plateb vyřešte stav účtu.
Pending approval	Zpracovatel online plateb obchodníka dosud neschválil.	Dokončete onboarding a doplňte všechny vyžádané informace.
No payment gateway	Online platby jsou schválené, ale obchodník nemá nakonfigurovanou platební bránu.	Kontaktujte společnost Tapaya a dokončete nastavení brány.
Ready	Obchodník je aktivní, online platby jsou schválené a brána je nakonfigurovaná.	Nakonfigurujte klíče, platební metody a případné návratové URL pro Hosted Checkout.

Zkopírujte Merchant token pro režim platformy, nebo výběrem Settings obchodníka nakonfigurujte. Nastavení Checkoutu mohou upravovat pouze administrátoři organizace.

Vytvoření Checkout klíčů obchodníka

V části Settings obchodníka najdete Merchant checkout keys, seznam klíčů pro vlastní backend tohoto obchodníka. Zadejte název klíče a zvolte Create merchant key. Klíče začínají na tapaya_test_ v sandboxu a na tapaya_live_ v produkčním prostředí.

Tajný klíč si ihned zkopírujte. Tapaya Platform jej zobrazí pouze jednou a ukládá jen jeho hash. Klíč funguje pouze pro svého obchodníka. Zrušením klíče zastavíte požadavky, které jej používají; ostatní klíče obchodníka i klíče vaší organizace zůstávají platné. Viz autentizaci Checkoutu.

Konfigurace návratových cílů

Hosted Checkout vrací zákazníka do vašeho obchodu po zaplacení nebo když platbu opustí. Platby v Embedded Checkoutu přesměrovací URL nepoužívají.

Návratové cíle patří k přihlašovacímu údaji, kterým se relace vytváří:

Přihlašovací údaj	Kde se konfiguruje	Na co se vztahuje
Secret key organizace s `X-Tapaya-Merchant-Token` (režim platformy)	Organization defaults › Redirect URLs	Relace všech obchodníků vytvořené backendem vaší platformy
Checkout klíč obchodníka	Nastavení obchodníka › Merchant API key redirects	Pouze relace vytvořené klíči daného obchodníka

Tato dvě nastavení se nikdy nekombinují a žádné z nich se nepoužije jako záloha za druhé. Relace v režimu platformy se může vrátit pouze na povolené weby organizace a relace vytvořená klíčem obchodníka pouze na povolené weby obchodníka. Pokud relace vynechá successUrl nebo cancelUrl a její přihlašovací údaj nemá výchozí hodnotu, vytvoření se odmítne.

V sekci pro váš přihlašovací údaj přidejte svůj obchod do Allowed websites a poté nastavte Default success URL a Default cancel URL. Obchod může použít například:

Povolený web: https://shop.example.
URL pro úspěch: https://shop.example/checkout/return.
URL pro zrušení: https://shop.example/checkout/cancel.

Povolený web je origin: schéma, hostitel a volitelný port, bez cesty, dotazu nebo fragmentu. Porovnává se přesný origin včetně portu. Zástupné znaky ani přípony názvu hostitele se za shodu nepovažují. Pro nasazené obchody používejte HTTPS; HTTP se přijímá pro lokální hostitele.

Relace může výchozí hodnoty přepsat pomocí successUrl nebo cancelUrl, když ji vytváříte. Přepsané hodnoty musí i tak odpovídat povolenému webu stejného přihlašovacího údaje. Platforma, která obsluhuje obchodníky na různých cestách nebo subdoménách, obvykle předává obě URL v každé relaci.

Stav Ready popisuje schválení obchodníka a nastavení brány. Nepotvrzuje konfiguraci vašich návratových URL. Platby v Embedded Checkoutu návratové URL nepotřebují. Hostované relace potřebují výchozí hodnoty nebo explicitně povolené URL pro přihlašovací údaj, který používají.

Návštěva kterékoli návratové URL výsledek platby nedokazuje. Než objednávku označíte jako zaplacenou, načtěte relaci ze svého serveru.

Nastavení názvu zobrazovaného zákazníkům

Customer-facing name se zobrazuje v Checkoutu a v platebních peněženkách. Pokud pole ponecháte prázdné, použije se oficiální název obchodníka. Název na bankovním výpisu se tím nemění.

Peněženky a vzhled

Každý obchodník buď zvolí Use organization wallets and appearance, nebo si nastaví vlastní. Tento přepínač neovlivňuje návratové cíle, které se řídí přihlašovacím údajem, jak je popsáno výše. Název obchodníka a Checkout klíče jsou vždy specifické pro daného obchodníka.

Organization defaults pro peněženky a vzhled platí pro každého obchodníka, který je používá, a změny se k těmto obchodníkům dostanou okamžitě:

Apple Pay a Google Pay. Karty jsou vždy povolené.
Hide powered by Tapaya.
Checkout color, šestimístná hexadecimální barva, například #1380A5.
Checkout logo, obrázek PNG nebo WebP o velikosti do 5 MB. Nahrání a odebrání loga se uloží okamžitě.

Pokud nejsou uložena žádná výchozí nastavení, peněženky jsou zapnuté a barva a logo se přebírají z brandingu vaší organizace.

Tlačítko peněženky závisí také na zařízení a prohlížeči zákazníka. Povolení peněženky nezaručuje, že se zobrazí všude. Ostrý provoz Google Pay vyžaduje nakonfigurované Google Pay merchant ID.

Hosted Checkout používá všechna tato nastavení. Embedded Checkout používá nastavení peněženek a výslednou barvu Checkoutu jako zvýraznění fokusu polí pro kartu (colorFocus). Proměnné, které vaše stránka předá v appearance.variables, ji přepíšou. Tlačítka peněženek v Embedded Checkoutu povolte na své stránce podle postupu na stránce Embedded Checkout.

Pomocí Checkout preview zkontrolujte branding a platební metody v rozvržení pro počítače i mobilní zařízení.

Registrace domén obchodu pro Apple Pay

Pro Apple Pay v Embedded Checkoutu zaregistrujte každý název hostitele obchodu, na kterém se peněženka zobrazuje. Hosted Checkout běží na doméně Tapaya. Allowed websites pro hostovaná přesměrování doménu pro Apple Pay neregistrují.

Otevřete Settings obchodníka, poté Apple Pay a Shop domains.
Zvolte Add domain a stáhněte ověřovací soubor.
Soubor zpřístupněte beze změny a bez přípony na adrese https://shop.example/.well-known/apple-developer-merchantid-domain-association. Použijte platný certifikát HTTPS a soubor zpřístupněte přímo, bez přesměrování.
Zadejte název hostitele, například shop.example, a zvolte Verify and add. Pokud zákazníci používají i www.shop.example, zaregistrujte jej samostatně.
Počkejte, až se u domény zobrazí Active, a poté povolte Apple Pay. Pomocí Check now diagnostikujete doménu, která selhává.

Ověřovací soubor ponechte dostupný i po registraci. Každý obchodník potřebuje vlastní registraci domény, i když peněženky a vzhled přebírá z výchozího nastavení organizace. Než lze doménu zaregistrovat, musí mít obchodník nakonfigurovanou platební bránu.

Chybí vám něco na této stránce?Navrhněte funkci. Připojíme tuto stránku, aby tým viděl souvislosti.