Sari la conținut

Obtinere oferte

/api/online/offers

Solicita ofertele de creditare pe baza produselor si a preferintelor transmise.

Parametrii GET

Parametru	Explicatie	Format	Necesar
`selectFirst`	Daca este `true`, raspunsul contine direct URL-ul pentru continuarea procesului pe platforma UniCredit ePOS. In acest caz, `email_address` devine necesar.	boolean	NU

Parametrii POST

Parametru	Explicatie	Format	Necesar
`products`	Lista produselor ce vor intra in oferta de creditare	array of objects	DA
`due_date`	Data (ziua din luna) pentru plata ratei aferente serviciului de creditare	integer	NU
`credit_period`	Durata pentru care se doreste serviciul de creditare (in luni)	integer	NU
`insurance`	Clientul doreste asigurare pentru serviciul de creditare	boolean	NU
`gdpr`	Acordul GDPR pentru inceperea aplicatiei de creditare	boolean	DA
`email_address`	Adresa de e-mail a clientului. Devine NECESAR daca este folosit parametrul GET `selectFirst`.	string	NU
`phone_number`	Numarul de telefon al clientului	string	NU
`first_name`	Prenumele clientului	string	NU
`last_name`	Numele clientului	string	NU
`offerId`	ID-ul unei constructii de credit predefinite pe baza careia sa primiti oferta	integer	NU
`external_id`	ID-ul comenzii folosit pentru identificarea ulterioara a ofertei (callback / redirect / update-uri)	string	DA
`redirect_url`	URL-ul folosit pentru redirectionarea clientilor de pe platforma noastra. Optional — poate fi definit si programatic, fara a fi trimis per request.	string	NU
`callback_url`	URL-ul ce va fi folosit pentru callback la finalizarea aplicatiei. Optional — poate fi definit si programatic, fara a fi trimis per request.	string	NU
`loyalty_code`	Codul de loializare (pentru oferte de card co-brand)	string	NU

Structura obiect produs (`products[]`)

Parametru	Explicatie	Format	Necesar
`name`	Denumirea produsului	string	DA
`category`	ID alfanumeric al categoriei (daca exista mapare intre categoriile dvs. si cele interne UniCredit ePOS)	string	NU
`price`	Pretul per produs, cu pana la 2 zecimale	float, 2 zecimale	DA
`quantity`	Cantitatea de produse	integer	DA

Exemplu apel — offers

{
  "products": [
    {
      "name": "Denumire produs 1",
      "category": 123,
      "price": 1345,
      "quantity": 1
    },
    {
      "name": "Denumire produs 2",
      "category": 1234,
      "price": 1345,
      "quantity": 1
    }
  ],
  "insurance": false,
  "due_date": 3,
  "credit_period": 60,
  "gdpr": true,
  "offerId": 109719,
  "phone_number": "0700123456",
  "email_address": "email@domain.com",
  "first_name": "Ion",
  "last_name": "Popescu",
  "external_id": 100100,
  "redirect_url": "https://www.unicredit.ro?campaignParam=Unicredit&orderID=100100",
  "callback_url": "https://ext.partener.ro/callback",
  "loyalty_code": "Cod_loializare"
}

Exemplu raspuns — offers

{
  "success": true,
  "message": null,
  "data": {
    "offers": [
      {
        "id": 109719,
        "childId": 1,
        "name": "Oferta 1",
        "installment": 58.28,
        "interest": 0,
        "dae": 3.3367,
        "total_credit_amount": 3797,
        "loan_amount": 3497,
        "analysis_fee": 0,
        "credit_period_months": 60
      }
    ],
    "sessionID": "00ee3a2392a3eb1999a69f1a7c30d6f983af2ace4a71362b0b8825c7e700b6b2"
  }
}

Exemplu request — offers cu `selectFirst`

{
  "products": [
    {
      "name": "Denumire produs 1",
      "price": 1345,
      "quantity": 1
    },
    {
      "name": "Denumire produs 2",
      "price": 1345,
      "quantity": 1
    }
  ],
  "insurance": false,
  "due_date": 3,
  "credit_period": 60,
  "gdpr": true,
  "offerId": 109719,
  "email_address": "email@domain.com",
  "phone_number": "0700123456",
  "first_name": "Ion",
  "last_name": "Popescu",
  "external_id": 100100,
  "redirect_url": "https://www.unicredit.ro?campaignParam=Unicredit&orderID=100100",
  "callback_url": "https://ext.partener.ro/callback",
  "loyalty_code": "Cod_loializare"
}

Exemplu raspuns — offers cu `selectFirst`

{
  "success": true,
  "message": null,
  "data": {
    "sessionUrl": "URL"
  }
}

/api/online/selectOffer

Finalizeaza selectia unei oferte primite de la /api/online/offers si intoarce URL-ul de continuare a procesului pe platforma UniCredit ePOS.

Parametrii

Parametru	Explicatie	Format	Necesar
`sessionID`	Valoarea `sessionID` furnizata in raspunsul apelului `/api/online/offers`	string	DA
`offer_id`	ID-ul ofertei furnizat in raspunsul apelului `/api/online/offers`	integer	DA
`email_address`	Adresa de e-mail a clientului pentru care se initiaza aplicatia de creditare	string	DA

Exemplu request — selectOffer

{
  "sessionID": "fb7bb0eb5e92d017eed6aa9b541e6b5ea2b5e098adb1a62ccf33a7f9afc2d434",
  "offer_id": 109721,
  "email_address": "email@domain.com"
}

Exemplu raspuns — selectOffer

{
  "success": true,
  "message": null,
  "data": {
    "sessionUrl": "URL"
  }
}