Atlayo Pay pro PrestaShop
=========================

Platby kartou, Apple Pay a Google Pay přes Atlayo Pay. Bez měsíčního paušálu.
Verze 1.0.0. Pro PrestaShop 1.7.6 a novější, včetně 8 a 9 (kontrolováno proti zdrojům 1.7.8, 8.1 a 9.0). Potřebuje rozšíření PHP curl.
Modul je v angličtině a češtině.

Instalace
---------

1. V administraci PrestaShopu otevřete Moduly → Správce modulů → Nahrát modul a nahrajte atlayo-pay-prestashop.zip.
2. Klikněte na Nastavit.
3. Vložte tajný klíč a podpis webhooku z Atlayo Pay → API a integrace a uložte.
4. V Platba → Preference zkontrolujte, že je Atlayo Pay povolené pro vaše měny, země a skupiny zákazníků.

Po uložení nahoře uvidíte, jestli klíč funguje, v jakém je režimu (testovací nebo ostrý) a které měny jsou zapnuté.
Pro zkoušku vložte testovací klíč sk_atlayo_test_…. Platby pak neberou peníze.
Adresu webhooku nikam zadávat nemusíte, modul ji posílá s každou platbou. Musí být veřejná a s https.

Jak to funguje
--------------

Zákazník v pokladně vybere Platbu kartou, přejde na zabezpečenou stránku Atlayo Pay, zaplatí a vrátí se na stránku s potvrzením objednávky.
Objednávka v PrestaShopu vznikne, až když je platba skutečně zaplacená. Do té doby je to jen košík a nezdržuje sklad.
Potvrzení přijde z Atlayo Pay (webhook). Kdyby nedorazilo, modul platbu ověří při návratu zákazníka. Kdo z nich je rychlejší, objednávku vytvoří, nikdy ne dvakrát.
Dokud banka platbu nepotvrdí, zákazník vidí stránku, která se sama obnovuje.

Platba se v pokladně nenabídne, když měna zákazníka není zapnutá v Atlayo Pay, když je částka pod nejnižší platbou nebo když klíč není platný.
Částka se platí v měně, kterou si zákazník v obchodě zvolil.

Pozor: platba se spáruje s košíkem podle částky a měny. Když nesedí (například se košík mezi tím změnil),
objednávka vznikne se stavem Chyba platby a v poznámce k objednávce je napsáno, co se stalo. Takovou objednávku neodesílejte.

Poznámky k objednávce
---------------------

Co se s platbou děje, modul zapisuje do soukromé poznámky objednávky (v detailu objednávky v administraci): zaplaceno včetně poplatku,
vrácení peněz, spor u banky. Ve stejné poznámce uvidíte i testovací platby.

Vrácení peněz
-------------

Vrácení peněz se dělá v aplikaci Atlayo Pay (u platby). Modul ho do objednávky zapíše sám:
částečné vrácení jako poznámku, úplné vrácení změní stav na Vráceno (nastavíte). Zákazníkovi z toho nejde e-mail, ten rozhodujete vy.
Když se omylem zaplatí jeden košík dvakrát, druhá platba se jen zapíše do poznámky a vy ji v Atlayo Pay vrátíte.

Spory u banky
-------------

Když zákazník platbu rozporuje u své banky, modul to zapíše do objednávky a zaplacenou objednávku přepne do stavu Spor u banky (Atlayo Pay),
aby se neodeslala. Ten stav modul vytvoří při instalaci. Objednávka v něm dál platí jako prodej, takže se nemění sklad ani statistiky.
Objednávku, která už jde dál (odeslaná), nepřepíná, jen k ní přidá poznámku. Včasné varování od banky stav nikdy nemění.
Po vyhraném sporu se objednávka vrátí do stavu pro zaplacené z nastavení. Přepínání jde v nastavení vypnout volbou "Stav neměnit".
Podklady ke sporu posíláte v Atlayo Pay.

Záznamy
-------

Chyby spojení s Atlayo Pay a odmítnuté webhooky se zapisují do Pokročilé nastavení → Záznamy (hledejte "Atlayo Pay").
Volba Podrobné záznamy přidá i běžné události. Klíče se do záznamů nikdy nezapisují.

Databáze
--------

Při instalaci vznikne tabulka atlayopay_payment (číslo platby, košík, objednávka, stav, vrácená částka).
Při odinstalaci modulu zůstává, aby šly dál spárovat staré objednávky. Můžete ji kdykoli smazat.

Aktualizace
-----------

Nahrajte nový ZIP stejně jako při instalaci. Nastavení zůstává.

Co modul zatím neumí
--------------------

* Tlačítko Vrátit peníze přímo v objednávce. Vrací se v Atlayo Pay.
* Odběry a opakované platby.
* Dokončení platby v režimu údržby: PrestaShop tam webhook odmítne. Atlayo Pay ho zkusí poslat znovu, objednávka vznikne po vypnutí údržby.

Changelog
---------

1.0.0
* První verze.
