Pluginy Home Credit splátky a Quatro splátky ponúkajú zákazníkovi platbu formou spotrebiteľského úveru (nákup na splátky) namiesto platby vopred. Zákazník žiadosť podpíše u poskytovateľa úveru; Ecommio o výsledku schválenia dostáva spätnú notifikáciu.
Čo pluginy robia
Po výbere splátok v pokladni sa zákazník presmeruje na stránku poskytovateľa, kde žiadosť o úver podpíše. Home Credit aj Quatro následne posielajú notifikáciu o stave žiadosti — schválenej, podpísanej alebo zamietnutej. Obe pluginy vedia voliteľne zobraziť na stránke produktu kalkulačku alebo orientačnú výšku mesačnej splátky.
Požiadavky
Zmluva s Home Credit (partnerský účet) alebo s VÚB pre Quatro (obchodné číslo OZ a API kľúč).
Nastavenia — Home Credit
| Pole | Význam |
|---|---|
| Prostredie | SK test/produkcia (EUR) alebo CZ test/produkcia (CZK). Produkčné údaje pridelí Home Credit pri zmluve. Predvolené: SK – test (EUR). |
| Partner username | Prihlasovacie meno partnera pridelené Home Creditom (napr. 024243tech pre test). |
| Partner heslo | Heslo partnera. Po uložení sa zašifruje; nechajte prázdne pre zachovanie existujúceho. |
| Kalkulačka splátok na produkte | Zobrazí na detaile produktu tlačidlo „Nákup na splátky" s kalkulačkou Home Credit (modálne okno). Predvolené: vypnuté. |
| Kalkulačka — public API key | Verejný kľúč kalkulačky od Home Credit (napr. calculator_test_key) — nie je to partner heslo. |
| Kalkulačka — productSetCode | Kód produktovej sady pre kalkulačku (napr. COCHCONL), pridelí Home Credit. |
| Kalkulačka — URL widget skriptu | Adresa widget skriptu (app.js) od Home Credit. Bez nej sa kalkulačka nezobrazí. |
| Orientačná splátka — počet mesiacov | Ak vyplníte (napr. 24), pri produkte sa zobrazí orientačná mesačná splátka „≈ cena ÷ počet mesiacov". Presný výpočet s navýšením spraví kalkulačka. Prázdne = nezobrazovať. |
Nastavenia — Quatro
| Pole | Význam |
|---|---|
| Číslo obchodníka (OZ) | Pridelí Quatro (VÚB) pri zmluve. Používa sa aj v kalkulačke. |
| API kľúč | Slúži na prihlásenie aj na overenie podpisu spätnej notifikácie. Po uložení sa zašifruje; nechajte prázdne pre zachovanie existujúceho. |
| URL zákazníckej brány | Zákaznícka Quatro brána (kalkulačka), bez lomky na konci. |
| URL API | Quatro API pre žiadosti, bez lomky na konci. |
| Kalkulačka splátok na produkte | Zobrazí na detaile produktu odkaz na Quatro kalkulačku — len pri cene od 100 €. Predvolené: vypnuté. |
| Orientačná splátka — počet mesiacov | Rovnaký princíp ako pri Home Credit — orientačný výpočet, presnú sumu dá kalkulačka. |
Inštalácia a nastavenie
- Otvorte Systém > Pluginy a zapnite Home Credit splátky alebo Quatro splátky.
- Vyplňte prístupové údaje od poskytovateľa (Partner username/heslo pri Home Credit, Číslo obchodníka (OZ) a API kľúč pri Quatro).
- Zvoľte Prostredie (Home Credit) alebo skontrolujte URL polia (Quatro) podľa toho, či ešte testujete.
- Ak chcete kalkulačku na stránke produktu, zapnite ju a doplňte jej vlastné prístupové údaje — sú samostatné, nie totožné s prihlasovacími údajmi na žiadosti.
- Uložte nastavenia.
Testovací/sandbox režim
Home Credit má samostatnú voľbu Prostredie (SK test/produkcia, CZ test/produkcia) — mení adresu API aj menu (SK = EUR, CZ = CZK). Quatro nemá prepínač — testovacie a produkčné prostredie sa rieši úpravou polí URL zákazníckej brány a URL API.
Čo sa deje na objednávke
Schválenie úveru je asynchrónne — po presmerovaní na podpis zmluvy sa zákazník k e-shopu vráti ešte pred tým, než je jasné, či úver skutočne prešiel. Konečný stav prichádza až spätnou notifikáciou od poskytovateľa, ktorú si Ecommio vždy ešte raz overí priamym dotazom (nespolieha sa len na obsah notifikácie). Až po potvrdení podpísanej/schválenej zmluvy sa objednávka označí ako zaplatená; zamietnutá alebo zrušená žiadosť necháva objednávku nezaplatenú.
Pri Home Credit sa priebeh objednávky (expedícia, dokončenie, zrušenie) posiela poskytovateľovi aj naďalej — zásielka a doručenie sa hlásia späť do Home Credit systému.
Refundácie
Ani Home Credit, ani Quatro nemajú refundačné API cez Ecommio — ide o spotrebiteľský úver, nie o platbu kartou. Zrušenie sa rieši cez stornovanie objednávky, nie cez refund.
Webhook
Home Credit posiela notifikáciu na payments/homecredit/notification, Quatro na payments/quatro/notification. Obe notifikácie Ecommio pred spracovaním overí — pri Quatro podpisom (hash), pri Home Credit opätovným dotazom na stav žiadosti.
Časté problémy
- Brána sa v pokladni nezobrazuje. Chýba niektorý povinný prístupový údaj — skontrolujte nastavenia príslušného pluginu.
- Kalkulačka na produkte sa nezobrazuje. Kalkulačka má vlastné, samostatné prístupové údaje (napríklad Kalkulačka — public API key) odlišné od prihlasovacích údajov na žiadosti — skontrolujte, že sú vyplnené všetky.
- Zákazník sa vrátil zo stránky poskytovateľa, ale objednávka nie je zaplatená. To je očakávané, kým nepríde potvrdzujúca notifikácia — schválenie úveru trvá dlhšie než platba kartou.
- Quatro kalkulačka sa nezobrazuje pri lacnejšom produkte. Kalkulačka sa ponúka len od ceny 100 €.
- Potrebujete vrátiť peniaze po zrušení objednávky. Riešte cez zrušenie/stornovanie objednávky u poskytovateľa úveru, nie cez refundáciu v Ecommio.