Jak platby fungují#
Modul plateb je společný. Používá ho e-shop, inzerce, katalog firem i diskuze — každý z nich si o platbu jen řekne a čeká na výsledek.
Co je platba#
Jeden pokus zaplatit určitou částku. Platba nese:
| Údaj | Poznámka |
|---|---|
| Částka a měna | |
| Kód platby | vaše označení, podle něj se platba hledá |
| Variabilní symbol | pro párování s bankou |
| Brána | kudy se platí |
| Uživatel a e-mail | kdo platí |
| Stav | kde je platba teď |
| Datum vzniku a zaplacení | |
| Popis | co se platí |
Stavy platby#
Stavů je dvanáct. Rozlišují se jemněji, než se na první pohled zdá — a rozdíly mezi nimi mají praktický dopad:
| Stav | Klíč | Význam |
|---|---|---|
| Neznámý | UNKNOWN |
stav se nepodařilo určit |
| Nová | NEW |
vznikla, zákazník ještě neplatil |
| Zahájená | START |
odešel na bránu |
| Čeká na zaplacení | PENDING |
brána potvrzení teprve pošle — třeba bankovní převod |
| Zaplacená | COMPLETED |
peníze dorazily |
| Zrušená | CANCELED |
zákazník platbu odklikl |
| Stornovaná bránou | VOIDED |
zrušila ji brána, ne zákazník |
| Vrácená (refundace) | REFUNDED |
peníze šly zpátky |
| Selhala | FAILED |
brána platbu odmítla |
| Expirovaná | EXPIRED |
zákazník ji nedokončil včas |
| Chybná částka | BAD_PRICE |
brána potvrdila jinou částku, než se čekalo |
| Neplatná | INVALID |
brána vrátila údaje, které nedávají smysl |
„Zrušená“ a „Stornovaná bránou“ nejsou totéž
První udělal zákazník, druhou brána — typicky kvůli podezření nebo vypršení na své straně. Při reklamaci platby se hodí vědět, která strana to zastavila.
„Chybná částka“ a „Neplatná“ jsou dva různé stavy
U první platba proběhla, jen na jinou částku. U druhé nesedí samotné údaje. Řeší se jinak, takže je nezaměňujte.
Čekající platba není zaplacená
U převodů a odložených plateb může „čeká“ trvat i několik dní. Zboží ani službu proti tomuto stavu neuvolňujte.
Špatná částka znamená, že sedí platba, ale ne peníze
Brána potvrdila jinou částku, než jaká se očekávala. Nebývá to chyba zákazníka — spíš změna ceny mezi založením platby a jejím zaplacením. Řeší se ručně a je potřeba se na to podívat.
Kdo stav mění#
Stav mění brána, ne administrátor. Přichází zprávou z brány na adresu, kterou jí systém při zahájení platby předal.
Návrat zákazníka do e-shopu není potvrzení platby
Zákazník se může vrátit dřív, než brána potvrzení pošle, nebo naopak okno zavřít, i když zaplatil. Rozhoduje zpráva od brány. Proto se stav může změnit i dlouho po tom, co zákazník od počítače odešel.
Konečný stav brána nepřepíše#
Jakmile je platba zaplacená nebo vrácená, další zpráva z brány její stav už nezmění. Totéž platí pro zaplacenou platbu, kterou jste ručně zrušili. Pozdní nebo opakovaná zpráva brány se jen zapíše do komunikace s bránou. Takový stav můžete změnit jen vy v administraci.
Výjimkou je nová zaplacená transakce téže platby — zákazník zaplatil znovu. U tarifu se služba aktivuje znovu (viz opakovaná aktivace), u objednávky e-shopu jde o přeplatek k vrácení.
Nezaplacená zrušená platba zůstává otevřená — zákazník ji může zaplatit znovu.
Ruční úprava platby#
V Systém → Platby můžete platbu upravit. Platí přitom tři pravidla:
| Pravidlo | Co to znamená |
|---|---|
| Změny se zaznamenávají | každá změna stavu, částky, měny, stavu fakturace a data zaplacení se po uložení zapíše do auditního záznamu na serveru (soubor log/paymentAudit.log): kdo, kdy, z čeho na co |
| Platbu s dokladem nejde přecenit | má-li platba vystavený doklad, formulář změnu částky ani měny neuloží a ukáže hlášku u pole. Rozdíl opravte dobropisem nebo novým dokladem ve Fakturaci |
| Zrušenou objednávku nejde zaplatit | u platby za zrušenou nebo expirovanou objednávku e-shopu neprojde platební stránka ani nová transakce u brány |
Ručně měňte stav jen s důvodem
Auditní záznam ukáže, kdo platbu změnil, ne proč. Důvod si poznamenejte k platbě nebo k objednávce.
Co se stane po zaplacení#
Platba sama nic neaktivuje. Zavolá callback — obsluhu, která patří modulu, jenž si o platbu řekl.
| Modul | Co udělá |
|---|---|
| E-shop | posune objednávku |
| Inzerce | zaplatí inzerát nebo topování |
| Katalog firem | prodlouží zápis |
| Členství | prodlouží platnost tarifu |
Viz Regiony a callbacky.
Poplatek brány#
U platby se eviduje poplatek — pevná částka, procento nebo obojí. Ukládá se k platbě, takže je zpětně vidět, kolik brána stála.
Vazba na fakturaci#
Zaplacená platba si může vyžádat doklad. Které stavy a jaký typ dokladu, se nastavuje v nastavení fakturace.
Jedna platba může mít víc dokladů
Řádnou fakturu a k ní dobropis nebo storno. Dobropis z platby se ale vystaví jen na tu část, která ještě dobropisovaná není — když už je dobropisované všechno, další doklad nevznikne. Podrobně Faktury.
Platby objednávek fakturuje e-shop
K platbě za objednávku e-shopu nevystavuje doklad automatické zpracování plateb, ale e-shop podle stavu objednávky (třeba až při expedici). Doklad k takové platbě tedy hledejte u objednávky.
Kde platby najdete#
Systém → Platby — přehled všech. Kromě stavu a částky je u platby vidět i komunikace s bránou, což je první místo, kam se dívat, když něco nesedí.
Sloupec Stav ukazuje přesný stav platby. Jeho filtr stavy sdružuje do čtyř skupin:
| Volba filtru | Které stavy zahrnuje |
|---|---|
| Dokončené | Zaplacená |
| Čekající | Nová, Zahájená, Čeká na zaplacení |
| Neúspěšné | Zrušená, Selhala, Expirovaná, Chybná částka, Neplatná |
| Ostatní | všechny zbylé (Neznámý, Vrácená (refundace), Stornovaná bránou) |
Stejně stavy počítá widget Platby podle stavu na ploše; kliknutím na jeho část otevřete výpis plateb s odpovídajícím filtrem.
Komunikace s bránou#
Brána jednu platbu často ohlásí víckrát — zákazník se vrátí z platební stránky, brána pošle upozornění na pozadí a někdy totéž zopakuje. Každé takové oznámení se zapíše. Seznam najdete v úpravě platby na záložce Komunikace s bránou (nejnovější nahoře); z přehledu plateb se na ni dostanete rovnou ikonou oka u řádku.
| Sloupec | Co znamená |
|---|---|
| Přijato | kdy oznámení dorazilo |
| Kanál | Návrat / upozornění brány, Doručenka / upozornění serveru nebo SMS |
| ID u brány | číslo transakce, pod kterým platbu vede brána |
| Stav od brány a Částka od brány | co brána nahlásila |
| Výsledek | Zpracováno (oznámení změnilo platbu), Bez změny (opakovaná nebo pozdní zpráva k už uzavřené platbě), Odmítnuto (nesedí platba, částka nebo měna — důvod je uvedený), Chyba (zpracování selhalo) |
Záznamy starší než nastavená doba se jednou denně mažou — viz úklidové úlohy.