Atlayo Pay pro OpenCart
=======================

Platby kartou, Apple Pay a Google Pay přes Atlayo Pay. Bez měsíčního paušálu.
Verze 1.0.0. Pro OpenCart 3.0.x (kontrolováno proti verzi 3.0.3.9). Potřebuje rozšíření PHP curl.
Modul je v angličtině a češtině.

Instalace
---------

1. V administraci OpenCartu otevřete Rozšíření → Instalátor a nahrajte atlayo-pay-opencart.ocmod.zip.
2. Otevřete Rozšíření → Rozšíření, vyberte typ Platby a u Atlayo Pay klikněte na zelené plus (Instalovat).
3. Klikněte na modré tlačítko Upravit.
4. Vložte tajný klíč a podpis webhooku z Atlayo Pay → API a integrace.
5. Stav přepněte na Zapnuto a uložte.

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ě klikne na Zaplatit, přejde na zabezpečenou stránku Atlayo Pay, zaplatí a vrátí se na stránku s poděkováním.
Objednávka se v OpenCartu potvrdí, až když je platba skutečně zaplacená. Do té doby zůstává mezi chybějícími objednávkami a nesnižuje sklad.
Potvrzení přijde z Atlayo Pay (webhook). Kdyby nedorazil, modul platbu ověří při návratu zákazníka.

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 objednávkou podle částky a měny. Když nesedí, objednávka se nepotvrdí jako zaplacená,
dostane stav z nastavení (Chybné) a v historii objednávky je poznámka, co se stalo.

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ácené (nastavíte).
Když se omylem zaplatí jedna objednávka 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 pro spory
(výchozí je Charge-back), aby se neodeslala. Objednávku, která už je odeslaná, nepřepíná, jen k ní přidá poznámku.
Po vyhraném sporu se objednávka vrátí do stavu pro zaplacené objednávky z nastavení. Přepínání jde v nastavení vypnout volbou "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 souboru atlayo_pay.log ve složce záznamů OpenCartu (ve výchozím nastavení system/storage/logs).
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 atlayo_pay_payment (číslo platby, 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 přes Rozšíření → Instalátor a přepište soubory. Nastavení zůstává.

Odinstalace
-----------

Rozšíření → Rozšíření → Platby → u Atlayo Pay červené tlačítko (Odinstalovat). Potom můžete smazat soubory modulu:
admin/*/extension/payment/atlayo_pay*, catalog/*/extension/payment/atlayo_pay*, system/library/atlayo_pay/.

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

* OpenCart 2.x a 4.x. Modul je pro řadu 3.0.
* Tlačítko Vrátit peníze přímo v objednávce. Vrací se v Atlayo Pay.
* Odběry a opakované platby.

Changelog
---------

1.0.0
* První verze.
