Nastavenia Checkoutu

Overte schválenie obchodníka a spravujte návratové ciele, peňaženky, branding a kľúče Checkoutu v Tapaya Platform.

V Tapaya Platform 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 alebo Embedded Checkout.

Čo jednotlivé integrácie potrebujú

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

Nastavenie	Hosted Checkout	Embedded Checkout
Onboarding obchodníka až do stavu Ready	Povinné	Povinné
Checkout kľúče obchodníka	Režim obchodníka	Režim obchodníka
Návratové ciele	Povinné	Nepoužíva sa
Názov zobrazovaný zákazníkom	Voliteľné	Voliteľné
Peňaženky a vzhľad	Voliteľné	Voliteľné
Domény obchodu pre Apple Pay	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.

Onboarding obchodníka pre Checkout

Dokončite onboarding obchodníka 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 alebo výberom Settings obchodníka nakonfigurujte. Nastavenia Checkoutu môžu upravovať iba administrátori organizácie.

Vytvorenie checkout kľúčov obchodníka

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.

Konfigurácia návratových cieľov

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)	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. 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

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

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.

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

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ú.

Otvorte Settings obchodníka, potom Apple Pay a Shop domains.
Zvoľte Add domain a stiahnite overovací súbor.
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í.
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.
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.

Chýba vám niečo na tejto stránke?Navrhnite funkciu. Pripojíme túto stránku, aby tím videl súvislosti.