Skip to content

Testovací prostředí

Jump to bottom
Home Credit CZ edited this page Jan 5, 2023 · 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í

Dostupné varianty entity konzumenta API na testovacím prostředí:

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_

Kalkulačka splátek

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

1. Vlastní řešení partnera

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í

2. Částečné řešení partnera s využitím javascriptovéhéo widgetu

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.

3. Home Creditem vystavená externí kalkulačka splátek

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

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é 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

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

Testovací průchod "schváleno"

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.cz/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.

Clone this wiki locally