Skip to content

Testovací prostředí

Home Credit CZ edited this page Jun 25, 2019 · 31 revisions

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.

Prerekvizity

  • 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

Prostředí

Kalkulačka splátek

Pro testovací účely jsou k dispozici následující varianty kalkulačky splátek:

  1. Lze využít námi vystavené kalkulační endpointy (viz TD)

  2. 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“

  3. Lze využít i Home Creditem vystavenou externí kalkulačku splátek ==> Testovací URI je např. https://hci-prod-myloan-train-cz-web-calculator.azurewebsites.net/kalkulace?productSetCode=COCHCONL&price=1000000&downPayment=0&apiKey=calculator_test_key&fixDownPayment=false (SK: https://hci-prod-myloan-sk-web-calculator.azurewebsites.net/kalkulace?productSetCode=COCHCONL&price=100000&downPayment=5000&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

Zkušební dotazy

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é na [https://github.com/homecreditcz v podobě archivu Create_application.zip](https://github.com/homecreditcz v podobě archivu Create_application.zip)

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

Práce se žádostí (Application) v integračním/testovacím režimu

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).