Přeskočit na hlavní obsah

Vytvořit žádost

POST 
/financing/v1/applications

Vyžaduje oprávnění applications.create pro autentizovaného uživatele

Elementární tok začíná v okamžiku, kdy chce zákazník využít některou z platebních metod Home Creditu pro financování svého nákupu v partnerském e-shopu.

Typ financováníPodporováno
INSTALLMENTANO

Použijte správně zdroj /financing/v1/applications

vyplněnou žádostí, která obsahuje alespoň následující údaje

  • Údaje o zákazníkovi není nutné zasílat, nicméně jejich zaslání je velmi doporučeno - zjednoduší to klientovi proces podání žádosti

    • Jméno (jméno a příjmení nebo celé jméno)
    • E-mail
    • Číslo mobilního telefonu
    • Adresa (pole)
      • Město
      • Ulice
      • Číslo ulice
      • PSČ
      • Typ adresy

  • Údaje o objednávce

    • Číslo
    • Celková cena (včetně DPH)
    • Položky objednávky (pole, je vyžadována alespoň jedna položka)
      • Kód
      • Název položky objednávky
      • Celková cena (všechny kusy včetně DPH)

  • Typ financování (vždy INSTALACE)

  • Údaje o typu financování

    • *Nastavení splátky - preferovaná výše splátky
    • *Nastavení splátek - preferovaná výše zálohy
    • *Nastavení splátky - preferovaný kód produktu programu

  • Další informace nezbytné pro pokračování a dokončení procesu

    • Vaše adresa URL, na kterou má být zákazník přesměrován po schválení žádosti
    • Vaše adresa URL, kam by měl být zákazník přesměrován po zamítnutí žádosti
    • Adresa URL koncového bodu oznámení, na který chcete, abychom zasílali oznámení o konkrétních aktualizacích aplikace (v případě, že partner používá notifikátor)
  • = Musí být správně vyplněno v případě, že zákazník již použil splátkovou kalkulačku vloženou na vašich webových stránkách a zvolil preferovaný splátkový program. Více informací o možnosti vložení splátkové kalkulačky na vaše webové stránky naleznete v části Zdroje splátkové kalkulačky. V opačném případě ponechte prázdné.

Pokud byl požadavek úspěšně zpracován, obdržíte v odpovědi stavový kód HTTP 201 a objekt aplikace s minimálně následujícími informacemi:

  • Unikátní ID aplikace

  • Stav aplikace

  • Podstav aplikace

  • Adresa URL přesměrování brány, kam máte zákazníka po zpracování odpovědi přesměrovat

Můžete také obdržet informaci o původně požadované platbě dolů - to

může být později zákazníkem změněna v průběhu procesu finalizace financování

žádosti. V takových případech doporučujeme zkontrolovat konečnou dodatečnou platbu

schváleného úvěru (po schválení žádosti) prostřednictvím /financování/v1/žádosti/{Id žádosti}.

Pokud byla žádost rozpoznána jako duplicita

  • a dříve vytvořená Žádost je zrušena (Žádost.stav = ZRUŠENÁa

Application.stateReason = CANCELLED_NOT_PAID), je vytvořena nová Application, vy

obdržíte stavový kód HTTP 201 a objekt Application s výše uvedenými informacemi (minimálně) v odpovědi

  • a dříve vytvořená Application je stále nová (tj. bez zaznamenané akce klienta), žádná Application není vytvořena, obdržíte stavový kód HTTP 200 a objekt Application vytvořený při prvním souvisejícím úspěšném volání zdroje.

  • a dříve vytvořená Aplikace již není zrušena ani nová, obdržíte stavový kód HTTP 422 s kódem chyby DUPLICATE_ORDER_NUMBER.

V případě chyby obdržíte jeden z následujících výsledků:

Stavový kódKódVysvětlení
400INVALID_REQUESTPožadavek nebyl správně naformátován (chybná syntaxe požadavku, příliš velká velikost atd.)
422UNPROCESSABLEPožadavek byl dobře zformulován, ale nebylo možné jej následovat kvůli sémantickým chybám
422DUPLICATE_ORDER_NUMBERVytvoření žádosti s duplicitním číslem objednávky není povoleno
500INTERNAL_SERVER_ERRORNastala neočekávaná podmínka a není vhodná žádná konkrétnější zpráva

Request​

Responses​

OK