-
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_sk
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
- SK: calculator_test_key_sk
tajný klíč pro hashování zpětné komunikace na e-shop:
- CZ: ..dw2{&q!.30
- SK: wq%?ch.q%5...
Pro testovací účely jsou k dispozici následující varianty kalkulačky splátek:
-
Lze využít námi vystavené kalkulační endpointy (viz TD)
-
Lze využít také 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 (viz TD) – k dispozici na adrese https://github.com/homecreditcz/widget-calculator
Testovací hodnoty jsou popsány v kapitole „Kalkulačka splátek – varianta javascriptový widget“
-
Lze využít i Home Creditem vystavenou externí kalkulačku splátek ==> Testovací URI je např.
- CZ: https://kalkulacka.train.hciapp.net/?productSetCode=COCHCONL&price=1000000&downPayment=0&apiKey=calculator_test_key&fixDownPayment=false
- SK: https://hcsk-train-hc-calc-standalone.azurewebsites.net/?productSetCode=COCHCONL&price=1000000&downPayment=0&apiKey=calculator_test_key&fixDownPayment=false
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 je true, podpora akontace v kalkulačce je vypnutá (vždy nulová), pokud false, 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.