# Nastavenia Checkoutu (/sk/online/integration/checkout_settings)



V [Tapaya Platform](https://platform.tapaya.com/checkout-settings) otvorte **Checkout**. Stránka zobrazuje **Organization defaults** (predvolené nastavenia organizácie) a zoznam **Checkout merchants** (obchodníci Checkoutu) vašej organizácie. Výberom obchodníka otvoríte stránku jeho nastavení. Obchodníka tu nakonfigurujte skôr, ako [integrujete Hosted Checkout](/online/integration/hosted_checkout) alebo [Embedded Checkout](/online/integration/embedded_checkout).

## Čo jednotlivé integrácie potrebujú [#what-each-integration-needs]

Prejdite nastavenia, ktoré vaša integrácia používa, zhora nadol:

| Nastavenie                                                                      |  Hosted Checkout | Embedded Checkout |
| ------------------------------------------------------------------------------- | :--------------: | :---------------: |
| [Onboarding obchodníka](#onboard-a-merchant-for-checkout) až do stavu **Ready** |      Povinné     |      Povinné      |
| [Checkout kľúče obchodníka](#create-merchant-checkout-keys)                     | Režim obchodníka |  Režim obchodníka |
| [Návratové ciele](#configure-return-destinations)                               |      Povinné     |    Nepoužíva sa   |
| [Názov zobrazovaný zákazníkom](#set-the-customer-facing-name)                   |     Voliteľné    |     Voliteľné     |
| [Peňaženky a vzhľad](#wallets-and-appearance)                                   |     Voliteľné    |     Voliteľné     |
| [Domény obchodu pre Apple Pay](#register-apple-pay-shop-domains)                |   Nepoužíva sa   |   Pre Apple Pay   |

Režim platformy namiesto checkout kľúča obchodníka používa Secret key organizácie zo [stránky API Keys](https://platform.tapaya.com/api-keys/).

## Onboarding obchodníka pre Checkout [#onboard-a-merchant-for-checkout]

Dokončite [onboarding obchodníka](/merchants/onboarding) so zvolenými online platbami, prípadne s online platbami aj platbami v predajni. Online onboarding zhromažďuje web obchodu a údaje o online podnikaní. Obchodník, ktorý používa iba Checkout, nepotrebuje terminály.

Obchodníci, ktorí žiadajú o online platby, sa automaticky zobrazujú v zozname **Checkout merchants**, vrátane tých, ktorí čakajú na schválenie. Vytvorenie záznamu obchodníka ani checkout kľúča neznamená schválenie online platieb. Samotné schválenie platieb v predajni Checkout nesprístupní.

Tabuľka zobrazuje pripravenosť obchodníka:

| Stav                   | Význam                                                                         | Ďalší krok                                                                          |
| ---------------------- | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- |
| **Merchant inactive**  | Účet obchodníka je neaktívny.                                                  | Pred prijímaním platieb vyriešte stav účtu.                                         |
| **Pending approval**   | Spracovateľ online platieb obchodníka zatiaľ neschválil.                       | Dokončite onboarding a doplňte všetky vyžiadané informácie.                         |
| **No payment gateway** | Online platby sú schválené, ale obchodník nemá nakonfigurovanú platobnú bránu. | Kontaktujte spoločnosť Tapaya a dokončite nastavenie brány.                         |
| **Ready**              | Obchodník je aktívny, online platby sú schválené a brána je nakonfigurovaná.   | Nakonfigurujte kľúče, platobné metódy a prípadné návratové URL pre Hosted Checkout. |

Skopírujte **Merchant token** pre [režim platformy](/online/integration/api_integration#authentication) alebo výberom **Settings** obchodníka nakonfigurujte. Nastavenia Checkoutu môžu upravovať iba administrátori organizácie.

## Vytvorenie checkout kľúčov obchodníka [#create-merchant-checkout-keys]

V časti **Settings** obchodníka nájdete **Merchant checkout keys**, zoznam kľúčov pre vlastný backend tohto obchodníka. Zadajte názov kľúča a zvoľte **Create merchant key**. Kľúče začínajú na `tapaya_test_` v sandboxe a na `tapaya_live_` v produkčnom prostredí.

Tajný kľúč si ihneď skopírujte. Tapaya Platform ho zobrazí iba raz a ukladá len jeho hash. Kľúč funguje iba pre svojho obchodníka. Zneplatnením kľúča zastavíte požiadavky, ktoré ho používajú; ostatné kľúče obchodníka aj kľúče vašej organizácie zostávajú platné. Pozrite si [autentifikáciu Checkoutu](/online/integration/api_integration#authentication).

## Konfigurácia návratových cieľov [#configure-return-destinations]

Hosted Checkout vráti zákazníka do vášho obchodu po zaplatení alebo keď platbu opustí. Vložené platby presmerovacie URL nepoužívajú.

Návratové ciele patria k prihlasovaciemu údaju, ktorým sa relácia vytvára:

| Prihlasovací údaj                                                                                                          | Kde sa konfiguruje                                     | Na čo sa vzťahuje                                                |
| -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------- |
| Secret key organizácie s `X-Tapaya-Merchant-Token` ([režim platformy](/online/integration/api_integration#authentication)) | **Organization defaults** › **Redirect URLs**          | Relácie všetkých obchodníkov vytvorené backendom vašej platformy |
| Checkout kľúč obchodníka                                                                                                   | Nastavenia obchodníka › **Merchant API key redirects** | Iba relácie vytvorené kľúčmi daného obchodníka                   |

Tieto dve nastavenia sa nikdy nekombinujú a ani jedno nezastúpi druhé, ak chýba. Relácia v režime platformy sa môže vrátiť iba na povolené weby organizácie a relácia vytvorená kľúčom obchodníka iba na povolené weby obchodníka. Ak relácia vynechá `successUrl` alebo `cancelUrl` a jej prihlasovací údaj nemá predvolenú hodnotu, vytvorenie sa odmietne.

V sekcii pre váš prihlasovací údaj pridajte svoj obchod do **Allowed websites** a potom nastavte **Default success URL** a **Default cancel URL**. Obchod môže použiť napríklad:

* Povolený web: `https://shop.example`.
* URL úspechu: `https://shop.example/checkout/return`.
* URL zrušenia: `https://shop.example/checkout/cancel`.

Povolený web je origin: schéma, hostiteľ a voliteľný port, bez cesty, dopytu alebo fragmentu. Porovnáva sa presný origin vrátane portu. Zástupné znaky ani prípony názvu hostiteľa sa za zhodu nepovažujú. Pre nasadené obchody používajte HTTPS; HTTP sa prijíma pre lokálnych hostiteľov.

Relácia môže predvolené hodnoty prepísať pomocou `successUrl` alebo `cancelUrl`, keď ju [vytvárate](/online/integration/api_integration#create-a-checkout-session). Prepísané hodnoty musia aj tak zodpovedať povolenému webu toho istého prihlasovacieho údaja. Platforma, ktorá obsluhuje obchodníkov na rôznych cestách alebo subdoménach, zvyčajne odovzdáva obe URL v každej relácii.

Stav **Ready** opisuje schválenie obchodníka a nastavenie brány. Nepotvrdzuje konfiguráciu vašich návratových URL. Vložené platby návratové URL nepotrebujú. Hostované relácie potrebujú predvolené hodnoty alebo explicitne povolené URL pre prihlasovací údaj, ktorý používajú.

Návšteva ktorejkoľvek návratovej URL výsledok platby nedokazuje. Skôr ako objednávku označíte ako zaplatenú, načítajte reláciu zo svojho servera.

## Nastavenie názvu zobrazovaného zákazníkom [#set-the-customer-facing-name]

**Customer-facing name** sa zobrazuje v Checkoute a v platobných peňaženkách. Ak pole necháte prázdne, použije sa obchodné meno obchodníka. Názov na bankovom výpise sa tým nemení.

## Peňaženky a vzhľad [#wallets-and-appearance]

Každý obchodník buď zvolí **Use organization wallets and appearance**, alebo si nastaví vlastné. Tento prepínač neovplyvňuje návratové ciele, ktoré sa riadia prihlasovacím údajom, ako je opísané vyššie. Názov obchodníka a checkout kľúče sú vždy špecifické pre daného obchodníka.

**Organization defaults** pre peňaženky a vzhľad platia pre každého obchodníka, ktorý ich používa, a zmeny sa k týmto obchodníkom dostanú okamžite:

* **Apple Pay** a **Google Pay**. Karty sú vždy povolené.
* **Hide powered by Tapaya**.
* **Checkout color**, šesťmiestna hexadecimálna farba, napríklad `#1380A5`.
* **Checkout logo**, obrázok PNG alebo WebP s veľkosťou do 5 MB. Nahratie a odstránenie loga sa uloží okamžite.

Ak nie sú uložené žiadne predvolené nastavenia, peňaženky sú zapnuté a farba a logo sa preberajú z brandingu vašej organizácie.

Tlačidlo peňaženky závisí aj od zariadenia a prehliadača zákazníka. Povolenie peňaženky nezaručuje, že sa zobrazí všade. Ostrá prevádzka Google Pay vyžaduje nakonfigurované Google Pay merchant ID.

Hosted Checkout používa všetky tieto nastavenia. Embedded Checkout používa nastavenia peňaženiek a výslednú farbu Checkoutu ako zvýraznenie fokusu polí pre kartu (`colorFocus`). Premenné, ktoré vaša stránka odovzdá v `appearance.variables`, ju prepíšu. Tlačidlá peňaženiek vo vložených platbách povoľte na svojej stránke podľa postupu na stránke [Embedded Checkout](/online/integration/embedded_checkout#add-apple-pay-and-google-pay).

Pomocou **Checkout preview** skontrolujte branding a platobné metódy v rozložení pre počítače aj mobilné zariadenia.

## Registrácia domén obchodu pre Apple Pay [#register-apple-pay-shop-domains]

Pre Apple Pay v Embedded Checkoute zaregistrujte každý názov hostiteľa obchodu, na ktorom sa peňaženka zobrazuje. Hosted Checkout beží na doméne Tapaya. **Allowed websites** pre hostované presmerovania doménu pre Apple Pay neregistrujú.

1. Otvorte **Settings** obchodníka, potom **Apple Pay** a **Shop domains**.
2. Zvoľte **Add domain** a stiahnite overovací súbor.
3. Súbor sprístupnite bez zmeny a bez prípony na adrese `https://shop.example/.well-known/apple-developer-merchantid-domain-association`. Použite platný certifikát HTTPS a súbor sprístupnite priamo, bez presmerovaní.
4. Zadajte názov hostiteľa, napríklad `shop.example`, a zvoľte **Verify and add**. Ak zákazníci používajú aj `www.shop.example`, zaregistrujte ho samostatne.
5. Počkajte, kým sa pri doméne zobrazí **Active**, a potom povoľte Apple Pay. Pomocou **Check now** diagnostikujete doménu, ktorá zlyháva.

Overovací súbor nechajte dostupný aj po registrácii. Každý obchodník potrebuje vlastnú registráciu domény, aj keď peňaženky a vzhľad preberá z predvolených nastavení organizácie. Skôr ako možno doménu zaregistrovať, musí mať obchodník nakonfigurovanú platobnú bránu.