-
Notifications
You must be signed in to change notification settings - Fork 0
Testovací prostředí
Prostředí, na kterém jsou k dispozici data podobná produkčním a na kterém je možné si zkoušet implementaci volání jednotlivých endpointů. Případné problémy s těmito prostředími je potřeba řešit skrz integrace_eshop@homecredit.cz, nebo jiným speciálně dohodnutým kanálem.
- Abyste mohli provolávat testovací rozhraní (totéž pak platí i pro produkci), je potřeba nejprve získat přístupové údaje username + password, díky kterým pak budete moci získat přístupový token (access token), bez nějž není možné jednotlivé endpointy rozhraní provolávat (více detailů v TD).
- Přístupové údaje byste měli obdržet od zodpovědné osoby z HC na jedné z úvodních schůzek na téma integrace naší platební metody
-
Testovací prostředí je dostupné na:
-
Vzorový GET request by tak mohl být směrován např. na:
-
Zda je testovací prostředí funkční (a není na něm např. technická odstávka) lze zjistit pomocí health check endpointu (viz TD)
A) Prodej bez akontace (ID prodejny 024242)
username: 024242tech, password: 024242tech
apiKey pro kalkulačku splátek ve variantě javascriptový widget
- CZ:
calculator_test_key
- SK:
calculator_test_key
tajný klíč pro hashování zpětné komunikace na e-shop:
- CZ:
!;8ez62oe{*,_
- SK:
%j:o)t:y/8)
B) Prodej s akontací (ID prodejny 024243)
username: 024243tech, password: 024243tech
apiKey pro kalkulačku splátek ve variantě javascriptový widget
- CZ:
calculator_test_key_dp
- SK:
calculator_test_key_dp
tajný klíč pro hashování zpětné komunikace na e-shop:
- CZ:
..dw2{&q!.30
- SK:
wq%?ch.q%55r_
Pro testovací účely jsou k dispozici následující varianty kalkulačky splátek:
Vývojově nejnáročnější variantou je zcela vlastní řešení partnera postavené na kalkulačních endpointech (viz TD). Výhodou tohoto řešení je např. možnost tvorby uživatelského rozhraní kalkulačky zcela dle představ a UX požadavků partnera.
Pozn: Je třeba využívat variantu endpointů na train prostředí
Zlatou střední cestou je řešení, kdy vlastní backend e-shopu využívá javascriptový widget od Home Creditu, který obstarává frontendovou část, výpočet vhodných nabídek a na základě výsledku připravuje podklady backendu e-shopu pro provolání endpointu na vytvoření žádosti o úvěr.
- Javascriptový widget pro řešení kalkulačky splátek je k dispozici zde
- Testovací hodnoty jsou popsány v návodu na instalaci widgetu
Jde o jedinou variantu pro partnery spolupracující v režimu "Tipař"
Nejjednodušší cestou, kdy, kromě zabezpečení přesměrování klienta na stránku pro kalkulaci splátek skrz jednoduchý link, není potřeba žádný vývoj
Vzorová URI k přesměrování může vypadat např.
-
kde jednotlivé parametry znamenají:
-
productSetCode
– kód produktové sady, kterou máte obchodně domluvenou s Home Creditem -
price
– financovaná částka nákupu (tedy finální cena po odečtení případné akontace placené zákazníkem přímo) v haléřích/centech -
downPayment
– akontace v haléřích/centech -
apiKey
- přidělený API klíč -
fixDownPayment
– pokud jetrue
, podpora akontace v kalkulačce je vypnutá (vždy nulová), pokudfalse
, akontace je podporována
-
o Ještě před samotnou implementací lze chování rozhraní poměrně jednoduše zkoušet pomocí aplikace Postman, která se instaluje ve formě plug-inu do prohlížeče Chrome
o Úplné vzorové requesty, které lze právě pomocí aplikace Postman vyzkoušet, naleznete na konci tohoto dokumentu (případně v TD – u těch je ale potřeba použít relevantní data)
o Podkladová data pro vzorové requesty lze společně s jednoduchým návodem nalézt také zde
POZOR: Pro testovací účely používejte vždy financovanou částku nákupu větší než 1000,- (100000 v minor units) na CZ, a větší než 40 (4000 v minor units) na SK
Při testování v integrační fázi, pokud chcete ověřit celý proces
- od vytvoření žádosti o financování klientova nákupu
- přes jeho schválení a expedici/doručení
- po jeho úspěšné dokončení
je potřeba uměle nasimulovat klientovo chování ve front-endové aplikaci Home Creditu (MyLoan). K těmto účelům slouží speciální resource Change application state, jehož popis naleznete v technické dokumentaci https://csoneclicknew.docs.apiary.io/#reference/testing-&-integration. Tento resource funguje pouze na testovacích/integračních prostředích specifikovaných v tomto dokumentu (či technické dokumentaci).
Na testovacím prostředí (viz výše) existuje speciální účet pro schválení. Funkce účtu se aktivuje vyplněním položky příjmení = “Trener“ při vytváření žádosti pomocí resource Create Application (v requestu volání POST https://apicz-test.homecredit.net/verdun-train/financing/v1/applications
musí být customer.lastName = Trener
). Následně, ať už budete měnit stav objednávky pomocí speciálního resource Change state, nebo budete žádost vyplňovat „ručně“, bude tato žádost vždy schválena. Pro podpis smlouvy budete nakonec potřebovat OTP, které je pro testovací účely 123456.