Plugin PayPal pripája platbu cez PayPal — zákazník sa presmeruje na stránku PayPal, kde platbu schváli, a po návrate do e-shopu sa platba automaticky potvrdí.
Čo plugin robí
Po výbere platby PayPal v pokladni sa vytvorí objednávka priamo v PayPal a zákazník sa presmeruje na jej schválenie. Po návrate do e-shopu sa platba overí a strhne (zúčtuje). PayPal nemá v pokladni vlastný vstavaný formulár — schválenie platby prebieha výhradne na stránke PayPal.
Požiadavky
Účet v PayPal Developer Dashboard (sekcia My Apps & Credentials) s Client ID a Client Secret.
Nastavenia
| Pole | Význam |
|---|---|
| Prostredie | Sandbox (test) alebo Produkcia (live). Predvolené: Sandbox. |
| Client ID | REST API Client ID z PayPal Developer Dashboard. |
| Client Secret | REST API Secret z PayPal Developer Dashboard. Po uložení sa zašifruje; nechajte prázdne pre zachovanie existujúceho. |
Inštalácia a nastavenie
- Otvorte Systém > Pluginy a zapnite plugin PayPal.
- V PayPal Developer Dashboard (My Apps & Credentials) vytvorte alebo otvorte aplikáciu a skopírujte Client ID a Client Secret.
- Vložte ich do nastavení pluginu; kým platbu testujete, ponechajte Prostredie: Sandbox.
- Uložte nastavenia. Pred spustením naostro prepnite Prostredie na Produkcia a vložte produkčné údaje aplikácie.
Testovací/sandbox režim
Voľba Prostredie prepína celú adresu PayPal API medzi sandboxom a produkciou.
Čo sa deje na objednávke
Po schválení platby v PayPal sa zákazník vráti do e-shopu a Ecommio až vtedy zavolá PayPal API na strhnutie (capture) platby — samotný návrat teda platbu ešte nezaručuje, kým prebehne toto strhnutie. Suma sa porovná s pôvodnou objednávkou; pri nezhode ostane objednávka nezaplatená a označená na kontrolu. Zrušenie platby v PayPal necháva objednávku nezaplatenú a zákazník ju môže skúsiť zaplatiť znova.
Refundácie
PayPal podporuje refundáciu priamo z detailu objednávky v Ecommio.
Webhook
PayPal webhook nemá zapojený — platba sa potvrdzuje priamo pri návrate zákazníka z PayPal, nie cez samostatnú notifikáciu. Ak zákazník na stránke PayPal zaplatí, ale do e-shopu sa nevráti (zavrie kartu prehliadača), Ecommio o tom nemá ako vedieť a objednávka ostane nezaplatená, kým sa stav neskontroluje priamo v PayPal.
Časté problémy
- Brána sa v pokladni nezobrazuje. Chýba Client ID alebo Client Secret — doplňte ich v nastaveniach.
- Testovacia platba prešla ako ostrá (alebo naopak). Skontrolujte voľbu Prostredie — sandbox a produkcia používajú odlišné prihlasovacie údaje aplikácie v PayPal Developer Dashboard.
- Zákazník sa vrátil z PayPal, ale objednávka nie je zaplatená. Skontrolujte, či strhnutie platby prebehlo bez chyby — nezhoda sumy alebo zrušenie zo strany zákazníka ponechá objednávku nezaplatenú.
- Zákazník zrušil platbu v PayPal. Objednávka ostáva nezaplatená a zákazník ju môže dokončiť neskôr znova.
- Chcete testovať platbu bez reálnych peňazí. Použite Prostredie: Sandbox a testovací PayPal účet vytvorený v Developer Dashboard — sandbox a produkcia majú oddelené prihlasovacie údaje aj testovacie peniaze.