Quatro pre developerov

Volanie Quatro služieb pomocou URL

Splátkovať s Quatrom je veľmi jednoduché. Volanie služieb Quatro prebieha
vyskladavaním špecifickej url adresy.

V tejto časti nájdete všetky potrebné informácie ako na to.

Na vašom e-shope by mal mať zákazník k dispozícií:

• Informácia o splátkovom predaji cez Quatro 
  krátka informácia, že ako e-shop poskytujete splátkový predaj cez Quatro. Ideálne v sekcii platby a doprava alebo formou banneru na hlavnej stránke webu. Ak požadujete detailnejší popis procesu online nákupu na splátky, obráťte sa na svojho obchodného zástupcu.
   
• Quatro informatívna kalkulačka
  tlačidlo s preklikom, ktorým sa otvorí kalkulačka je umiestnený v detaile produktu, po kliknutí sa načíta Quatro kalkulačka so splátkovými produktmi
   
• Quatro – splátkový predaj
  tlačidlo alebo statický text sa zobrazí ako jedna z možností platby v nákupnom košíku pred odoslaním objednávky. Po úspešnom a záväznom odoslaní objednávky je zákazník presmerovaný z košíka priamo alebo cez medzistránku do novej Quatro žiadosti o nákup na splátky.

Quatro informatívna kalkulačka

Je potrebné, aby ste si na svoju stránku umiestnili grafické tlačidlo, ktoré sa štandardne zobrazuje v detaile produktu.
Prosím vyberte si jednu z možností:

Rozmer: 345x38px

Rozmer: 141x30px

Rozmer: 140x31px

Rozmer: 187x39px

Rozmer: 187x41px

Rozmer: 237x46px

Rozmer: 140x31px

Rozmer: 345x36px

Quatro informatívna kalkulačka - otvorenie URL

• Po kliknutí na grafické tlačidlo sa otvorí URL Quatro informatívnej kalkulačky
  
  Parametre informatívnej Quatro kalkulačky

  Parameter	Typ	Povinný údaj	Počet znakov	Popis
  {kód-predajne}	string	Áno	10	Kód predajne
  cenaTovaru	number	Áno	7	Cena tovaru * desatinné miesto v cene tovaru prosím oddeľujte znakom bodky "."

Vzor URL: https://quatro.vub.sk/kalkulacka/QTEST1?cenaTovaru=658.50

*možnosť otvárať kalkulačku v novom okne alebo popupe - záleží od spôsobu, ktorý si na svoj eshop zvolíte

Quatro - splátkový predaj

Quatro platobná metóda je jedna z platobných možností v košíku objednávky v sekcii Platba, po jej výbere a záväznom odoslaní objednávky v košíku je klient presmerovaný do prostredia Quatro žiadosti. Celková cena objednávky v košíku musí byť v rozmedzí od 100.00€ do 10000.00€. Počet položiek v objednávke nie je obmedzený. 

Názov tovaru na splátky musí byť v tvare "kategória - výrobca - typ".

Tento parameter sa bude zobrazovať na zmluvnej dokumentácii ako predmet úveru, čo podlieha pravidlám nastavených NBS o predmete financovania úveru.

Vzor 1:

Televízory - Samsung - UHD47U123456

Vzor 2:

Práčka - Whirlpool - AKG 456, Chladničky - Beko - DJ548, Služby - Predĺžená záruka - 24 mesiacov

Vzor 3:

Dovolenka - All Inclusiv Premium - Bali 10 dni, Car rent - Nissan - 10 dní

UPOZORNENIE:

Do predmetu nepatria položky z objednávky typu: poštovné, zľavové kupóny, príspevky na dobročinné organizáce, avšak hodnoty týchto doplnokových služieb sa zaratávajú do parametra "totalAmount". Povolená dlžka nesmie presiahnúť 250 znakov.

Quatro žiadosť URL script

Po záväznom odoslaní objednávky v košíku je potrebné presmerovať klienta na URL žiadosti.

VZOR:

https://quatroapi.vub.sk/stores/QTEST3/create-application?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJh
cHBsaWNhdGlvbiI6eyJvcmRlck51bWJlciI6Ik9CSjEyMzQ1NiIsImFwcGxpY2FudCI6eyJmaXJzdE5hbWUiOiJKXHU
wMGUxbiIsImxhc3ROYW1lIjoiTXJrdmlcdTAxMGRrYSIsImVtYWlsIjoidGVzdGVyQHZ1Yi5zayIsIm1vYmlsZSI6Iis0M
jE5MDQwMDAwMDAiLCJwZXJtYW5lbnRBZGRyZXNzIjp7ImFkZHJlc3NMaW5lIjoiQmVycm5vbFx1MDBlMWtvdmEg
MTciLCJjaXR5IjoiUG9wcmFkIiwiemlwQ29kZSI6IjA1ODAxIiwiY291bnRyeSI6IlNWSyJ9fSwic3ViamVjdCI6IkthdGVnb3
JpYSAtIFZ5cm9iY2EgVFlQIiwidG90YWxBbW91bnQiOiI1OTkuOTkiLCJnb29kc0FjdGlvbiI6IiIsImNhbGxiYWNrIjoiaH
R0cDpcL1wvcGRhYVwvamlyYVwvY2FsbGJhY2tcL2NhbGxiYWNrLnBocD9zdG9yZV9pZD1RVEVTVDMmb3JkZXJf
aWQ9T0JKMTIzNDU2In0sImlhdCI6MTU5OTIyMTE5N30.OmqJcS5lEygTik61wL6q1QRjAqOiEZvImsuTkXXwgtc

JWT Token

Pre vytvorenie JWT Tokenu je potrebné najskôr BEZPECNOSTNY_KLUC dekódovať algorytmom base64. Dekódovaný bezpečnostný kľúč sa následne použije pre podpísanie PAYLOADu algorytmom HS256.

Viac informácií k JWT nájdete tu: https://jwt.io/

Vzor:

HEADER

{
  "alg": "HS256",
  "typ": "JWT"
}

PAYLOAD

{
   'application': {
        'orderNumber': '987654',
        'applicant': {
            'firstName': 'Janko',
            'lastName': 'Hraško',
            'email': 'klient@email.com',
            'mobile': '+421904111000',
            'permanentAddress': {
                'addressLine': 'Nová 1',
                'city': 'Poprad',
                'zipCode': '05801',
                'country': 'SVK'
            },
        },
        'subject': 'Televízory - Samsung - UHD47U123456',
        'totalAmount': 1000.99,
        'goodsAction': null,
        'callback': 'https://vaseshop.sk/callback'
    },
    'iat': 123456 
}

VERIFY SIGNATURE

HMACSHA256(
  base64UrlEncode(HEADER) + "." +
  base64UrlEncode(PAYLOAD),
  base64Decode(BEZPECNOSTNY_KLUC)
)

Ako vytvoriť PAYLOAD?

Čo je Callback?

Ak si zvolíte aj parameter callback, zadanú url adresu budeme prevolávať metódou [GET] pri zmene stavu žiadosti:

https://vasaurlnacallback.sk/?id=ee1c9634-8462-4a73-8a66-c9af5164785b&cn=1000000111&state=approved

Požadovaná callback URL adresa eshopu

Parametre, ktoré dostanete od nás v odpovedi

ID: id žiadosti

CN: číslo žiadosti

State:

• approved (schválená čaká na podpis od klienta, pozn. z tohto stavu ešte môže vzniknúť stav canceled, ak zmluvu z akéhokoľvek dôvodu klient nepodpíše)
• signed (podpísaná, môžete expedovať tovar)
• canceled (jedniny konsolidovany stav pre: declined, expired a canceled)

V prípade nedostupnosti callbackurl je potrebné chybu ignorovať a pokracovať v procese.

Pluginy

Wordpress

Stiahnuť WordPress plugin

Prosím, stiahnite si a nainštalujte tento plugin vo vašom admin prostredí WordPressu.

Tento plugin slúži ako platobná brána pre splátkový predaj Quatro a informatívna kalkulačka.
Informatívna kalkulačka sa po nastavení bude zobrazovať v detaile produktu.
A Quatro platobná metóda sa vám zobrazí ako ďalšia voľba vo vašom nákupnom košíku.

Návod na inštaláciu pluginu:

PrestaShop

Stiahnuť PrestaShop plugin

Prosím, stiahnite si a nainštalujte tento modul vo vašom admin prostredí PrestaShopu.

Modul je prispôsobený pre verzie PrestaShopu 1.6. a 1.7.

Tento modul slúži ako platobná brána pre splátkový predaj Quatro a informatívna kalkulačka.
Informatívna kalkulačka sa po nastavení bude zobrazovať v detaile produktu.
A Quatro platobná metóda sa vám zobrazí ako ďalšia voľba vo vašom nákupnom košíku.

Návod na inštaláciu pluginu:

V novej verzii 1.1.7 je možné po inštalácii modulu (predchádzajúcu verziu je nutné odinštalovať), pridať do šablóny zavesenie v nasledujúcom znení cesta:

Pre PrestaShop verzia 1.7

themes/classic/templates/checkout/order-confirmation.tpl

Pre PrestaShop verzia 1.6

themes/nazovtemy/order-confirmation.tpl

{hook h='displayQuatroOrderConfirmation' objOrder=$order}

Toto zavesenie, zobrazí tlačidlo na presmerovanie pre dokončenie platby.

Tlačidlo je možné upravovať v šablóne týmito štýlmi.

.psquatro-payment-container

#btn-quatro-payment

Text tlačidla je možné upraviť v prekladoch modulu.

Zákazník mi chce reklamovať alebo vrátiť tovar, ako mám postupovať?

1. Odstúpenie od kúpnej zmluvy (môže nastať kedykoľvek do 2 rokov od zakúpenia tovaru, tzn. štandardná reklamácia)

Ak klient s tovarom nie je spokojný a vracia ho predajcovi, resp. tovar ešte neprevzal a to z dôvodu, že sa tovar ešte vyrába alebo nie je na sklade v požadovanom množstve (resp. je v stave objednávka a predajca nedodrží lehotu doručenia tovaru), klient má právo odstúpiť od kúpnej zmluvy (STORNO) a zároveň zo zákona zaniká aj zmluva o spotrebiteľskom úvere.

Predajca je povinný zaslať podpísanú žiadosť o zrušenie zmluvy (v aplikácií QPartner stlačením tlačidla storno zmluvy). Následne ju zašle e-mailom (scan) na adresu postove@vub.sk a v predmete e-mailu uvedie STORNO QUATRO. Zároveň je predajca povinný vrátiť VÚB a.s. zaplatené finančné plnenie. Ak klient zaplatil akontáciu predajcovi, predajca je povinný túto akontáciu vrátiť klientovi. Klientovi zasielame potvrdenie o zrušení zmluvy len na základe požiadavky klienta.

2. Odstúpenie od zmluvy o spotrebiteľskom úvere

Klient tovar nevracia predajcovi (tovar si klient necháva) - klientovi vyčísľujeme zostatok a zasielame mu ho poštou/elektronicky, následne nám klient na základe tohto vyčíslenia vyplatí zostatok úveru. Klientovi posielame potvrdenie o ukončení zmluvy, len na základe jeho požiadavky. Ak klient zaplatil akontáciu predajcovi, predajca túto akontáciu klientovi nevracia. Tento proces ide mimo eshopu. Ak chce klient odstúpiť od zmluvy o spotrebiteľskom úvere, nesmie predajca prevziať hotovosť za tovar na predajni od klienta. Odstúpenie od zmluvy o spotrebiteľskom úvere klient musí riešiť cez VÚB, a. s.
 

Čo je podmienkou vyplatenia finančného plnenia?

Podmienkou vyplatenia finančného plnenia je doručenie faktúry alebo dodacieho listu na e-mailovú adresu ipredaj@quatro.sk. Dodací list alebo faktúra musí byť vystavená na meno klienta, ktorý podpísal zmluvu o spotrebiteľskom úvere.
 

Kde nájdem informáciu o vyplatení finančného plnenia?

Zavolaním na infolinku kontaktného centra 0850 123 440 v pracovných dňoch od 7:00 do 18:00.
 

Mám 2 a viac e-shopov, je potrebné používať pre každý e-shop iný kód predajne?

Nie, podmienkou nie je používať pre každý e-shop iný kód predajne.
 

Nechodia mi e-mailové notifikácie o stave zmlúv a expedovaní tovaru, ako to riešiť?

Napíšte nám požiadavku na overenie stavu e-mailových notifikácií na e-mailovú adresu online@quatro.sk.
 

Nemám prístup do aplikácie Qpartner alebo som zabudol prihl. údaje, ako postupovať?

Napíšte nám požiadavku na e-mailovú adresu online@quatro.sk.