# Nastavení Checkoutu (/cs/online/integration/checkout_settings) V [Tapaya Platform](https://platform.tapaya.com/checkout-settings) 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](/online/integration/hosted_checkout) nebo [Embedded Checkout](/online/integration/embedded_checkout). ## Co jednotlivé integrace potřebují [#what-each-integration-needs] Projděte nastavení, která vaše integrace používá, odshora dolů: | Nastavení | Hosted Checkout | Embedded Checkout | | ------------------------------------------------------------------------------- | :--------------: | :---------------: | | [Onboarding obchodníka](#onboard-a-merchant-for-checkout) až do stavu **Ready** | Povinné | Povinné | | [Checkout klíče obchodníka](#create-merchant-checkout-keys) | Režim obchodníka | Režim obchodníka | | [Návratové cíle](#configure-return-destinations) | Povinné | Nepoužívá se | | [Název zobrazovaný zákazníkům](#set-the-customer-facing-name) | Volitelné | Volitelné | | [Peněženky a vzhled](#wallets-and-appearance) | Volitelné | Volitelné | | [Domény obchodu pro Apple Pay](#register-apple-pay-shop-domains) | 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](https://platform.tapaya.com/api-keys/). ## Onboarding obchodníka pro Checkout [#onboard-a-merchant-for-checkout] Dokončete [onboarding obchodníka](/merchants/onboarding) 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](/online/integration/api_integration#authentication), nebo výběrem **Settings** obchodníka nakonfigurujte. Nastavení Checkoutu mohou upravovat pouze administrátoři organizace. ## Vytvoření Checkout klíčů obchodníka [#create-merchant-checkout-keys] 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](/online/integration/api_integration#authentication). ## Konfigurace návratových cílů [#configure-return-destinations] 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](/online/integration/api_integration#authentication)) | **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](/online/integration/api_integration#create-a-checkout-session). 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 [#set-the-customer-facing-name] **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 [#wallets-and-appearance] 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](/online/integration/embedded_checkout#add-apple-pay-and-google-pay). 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 [#register-apple-pay-shop-domains] 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í. 1. Otevřete **Settings** obchodníka, poté **Apple Pay** a **Shop domains**. 2. Zvolte **Add domain** a stáhněte ověřovací soubor. 3. 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í. 4. 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ě. 5. 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.