Testovací prostředí

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í

• Testovací prostředí je dostupné na:

  • CZ: https://apicz-test.homecredit.net/verdun-train/
  • SK: https://apisk-test.homecredit.net/verdun-train/

• Vzorový GET request by tak mohl být směrován např. na:

  • CZ: https://apicz-test.homecredit.net/verdun-train/authentication/v1/partner
  • SK: https://apisk-test.homecredit.net/verdun-train/authentication/v1/partner

• Zda je testovací prostředí funkční (a není na něm např. technická odstávka) lze zjistit pomocí health check endpointu (viz TD)

  • CZ: https://apicz-test.homecredit.net/verdun-train/financing/v1/health
  • SK: https://apicz-test.homecredit.net/verdun-train/financing/v1/health

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

  Prodej bez akontace (ID prodejny 024242)

  username: 024242tech, password: 024242tech

  Prodej s akontací (ID prodejny 024243)

  username: 024243tech, password: 024243tech

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

• 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

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/oneclick-api 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).

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