UniCredit ePOS

https://epos.unicredit.ro/docs/
Admin
UniCredit ePOS is an API platform for integrating financing solutions into e-commerce platforms with...
Tokens:6,675
Snippets:49
Trust Score:9.3
Update:6 months ago
Show doc for...
Tokens:
Raw
### Response for offers with selectFirst

Source: https://epos.unicredit.ro/docs/guides/offers

Example JSON response structure returned when selecting the first offer.

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

--------------------------------

### POST /online/offers?selectFirst=true

Source: https://epos.unicredit.ro/docs/reference/offers

Retrieves a financial offer and automatically redirects to the session URL.

```APIDOC
## POST /online/offers?selectFirst=true

### Description
Retrieves a financial offer and returns a session URL directly, bypassing the offer selection list.

### Method
POST

### Endpoint
/online/offers?selectFirst=true

### Query Parameters
- **selectFirst** (boolean) - Required - Flag to automatically select the first offer

### Response
#### Success Response (200)
- **success** (boolean) - Status of the request
- **data** (object) - Contains sessionUrl

#### Response Example
{
  "success": true,
  "message": null,
  "data": {
    "sessionUrl": "URL"
  }
}
```

--------------------------------

### Exemplu corp cerere login

Source: https://epos.unicredit.ro/docs/guides/authentication

Formatul JSON recomandat pentru trimiterea credențialelor.

```json
{
  "email": "PARTENER@unicredit.ro",
  "password": "parolasecurizt@"
}
```

--------------------------------

### POST /online/offers?selectFirst=true Endpoint

Source: https://epos.unicredit.ro/docs/reference/offers

This endpoint retrieves financial offers and automatically selects the first one if `selectFirst=true` is appended to the URL. It requires an authorization token and a JSON payload.

```http
POST /online/offers?selectFirst=true
Authorization: Bearer <token>
Content-Type: application/json
```

```json
{
  "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"
}
```

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

--------------------------------

### Exemplu request — offers cu selectFirst

Source: https://epos.unicredit.ro/docs/guides/offers

Structura JSON pentru solicitarea ofertelor cu parametrul selectFirst activat.

```json
{
  "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"
}
```

--------------------------------

### POST /api/online/offers

Source: https://epos.unicredit.ro/docs/guides/offers

Requests credit offers based on the provided products and customer preferences. Requires Content-Type: application/json and Authorization: Bearer access_token.

```APIDOC
## POST /api/online/offers

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

### Method
POST

### Endpoint
/api/online/offers

### Parameters
#### Query Parameters
- **selectFirst** (boolean) - Optional - Daca este true, raspunsul contine direct URL-ul pentru continuarea procesului pe platforma UniCredit ePOS. In acest caz, email_address devine necesar.

#### Request Body
- **products** (array of objects) - Required - Lista produselor ce vor intra in oferta de creditare
- **due_date** (integer) - Optional - Data (ziua din luna) pentru plata ratei aferente serviciului de creditare
- **credit_period** (integer) - Optional - Durata pentru care se doreste serviciul de creditare (in luni)
- **insurance** (boolean) - Optional - Clientul doreste asigurare pentru serviciul de creditare
- **gdpr** (boolean) - Required - Acordul GDPR pentru inceperea aplicatiei de creditare
- **email_address** (string) - Optional - Adresa de e-mail a clientului. Devine NECESAR daca este folosit parametrul GET selectFirst.
- **phone_number** (string) - Optional - Numarul de telefon al clientului
- **first_name** (string) - Optional - Prenumele clientului
- **last_name** (string) - Optional - Numele clientului
- **offerId** (integer) - Optional - ID-ul unei constructii de credit predefinite
- **external_id** (string) - Required - ID-ul comenzii folosit pentru identificarea ulterioara a ofertei
- **redirect_url** (string) - Optional - URL-ul folosit pentru redirectionarea clientilor
- **callback_url** (string) - Optional - URL-ul ce va fi folosit pentru callback la finalizarea aplicatiei
- **loyalty_code** (string) - Optional - Codul de loializare

#### Structura obiect produs (products[])
- **name** (string) - Required - Denumirea produsului
- **category** (string) - Optional - ID alfanumeric al categoriei
- **price** (float) - Required - Pretul per produs, cu pana la 2 zecimale
- **quantity** (integer) - Required - Cantitatea de produse

### Request Example
{
  "products": [
    {
      "name": "Denumire produs 1",
      "category": 123,
      "price": 1345,
      "quantity": 1
    }
  ],
  "gdpr": true,
  "external_id": 100100
}

### Response
#### Success Response (200)
- **success** (boolean) - Statusul operatiunii
- **data** (object) - Obiect continand ofertele si sessionID

#### Response Example
{
  "success": true,
  "data": {
    "offers": [
      {
        "id": 109719,
        "name": "Oferta 1",
        "installment": 58.28
      }
    ],
    "sessionID": "00ee3a2392a3eb1999a69f1a7c30d6f983af2ace4a71362b0b8825c7e700b6b2"
  }
}
```

--------------------------------

### Exemplu apel — offers

Source: https://epos.unicredit.ro/docs/guides/offers

Structura JSON pentru solicitarea ofertelor de creditare.

```json
{
  "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"
}
```

--------------------------------

### Authentication & Offer Retrieval Flow

Source: https://epos.unicredit.ro/docs/guides/general

Overview of the minimal integration flow required to authenticate and fetch credit offers.

```APIDOC
## Authentication and Flow

### Description
The integration flow requires generating a Bearer token using provided credentials, followed by an offer query request. The response provides a URL for user redirection.

### Base URLs
- **Testing/Staging**: https://epos.unicredit.ro/TestOnline
- **Production**: https://epos.unicredit.ro

### Protocol
- **HTTPS**
- **Content-Type**: application/json
- **Authentication**: Bearer Token
```

--------------------------------

### POST /online/offers Endpoint

Source: https://epos.unicredit.ro/docs/reference/offers

Use this endpoint to retrieve financial offers. It requires an authorization token and a JSON payload with product details and customer information.

```http
POST /online/offers
Authorization: Bearer <token>
Content-Type: application/json
```

```json
{
  "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"
}
```

```json
{
  "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"
  }
}
```

--------------------------------

### Request for selectOffer

Source: https://epos.unicredit.ro/docs/guides/offers

JSON request body required to finalize an offer selection, including sessionID, offer_id, and email_address.

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

--------------------------------

### Exemplu raspuns — offers

Source: https://epos.unicredit.ro/docs/guides/offers

Structura JSON a raspunsului primit dupa solicitarea ofertelor.

```json
{
  "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"
  }
}
```

--------------------------------

### POST /online/offers

Source: https://epos.unicredit.ro/docs/reference/offers

Retrieves a list of financial offers based on the provided product and customer information.

```APIDOC
## POST /online/offers

### Description
Retrieves a list of available financial offers based on the provided product list and customer details.

### Method
POST

### Endpoint
/online/offers

### Request Body
- **products** (array) - Required - List of products
- **insurance** (boolean) - Required - Insurance status
- **due_date** (integer) - Required - Due date
- **credit_period** (integer) - Required - Credit period in months
- **gdpr** (boolean) - Required - GDPR consent
- **offerId** (integer) - Required - Offer identifier
- **phone_number** (string) - Required - Customer phone number
- **email_address** (string) - Required - Customer email
- **first_name** (string) - Required - Customer first name
- **last_name** (string) - Required - Customer last name
- **external_id** (integer) - Required - External reference ID
- **redirect_url** (string) - Required - URL to redirect after process
- **callback_url** (string) - Required - URL for server-to-server callback
- **loyalty_code** (string) - Optional - Loyalty program code

### Request Example
{
  "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"
}

### Response
#### Success Response (200)
- **success** (boolean) - Status of the request
- **data** (object) - Contains list of offers and sessionID

#### Response Example
{
  "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"
  }
}
```

--------------------------------

### Răspuns autentificare

Source: https://epos.unicredit.ro/docs/guides/authentication

Structura JSON returnată după un apel de login sau refreshToken reușit.

```json
{
    "token_type": "Bearer",
    "expires_in": 31622400,
    "access_token": "tokenAccess",
    "refresh_token": "tokenRefresh"
}
```

--------------------------------

### Apel login API

Source: https://epos.unicredit.ro/docs/guides/authentication

Structura cererii pentru endpoint-ul de autentificare.

```http
POST /api/online/login
Content-Type: application/json
```

--------------------------------

### POST /api/online/login

Source: https://epos.unicredit.ro/docs/guides/authentication

Authenticates a user and returns access and refresh tokens.

```APIDOC
## POST /api/online/login

### Description
Authenticates the user using email and password to obtain access and refresh tokens.

### Method
POST

### Endpoint
/api/online/login

### Request Body
- **email** (string) - Required - The partner email address.
- **password** (string) - Required - The user password.

### Request Example
{
  "email": "PARTENER@unicredit.ro",
  "password": "parolasecurizt@"
}

### Response
#### Success Response (200)
- **token_type** (string) - The type of token (Bearer).
- **expires_in** (integer) - Expiration time in seconds.
- **access_token** (string) - The access token for API authorization.
- **refresh_token** (string) - The token used to refresh the access token.

#### Response Example
{
    "token_type": "Bearer",
    "expires_in": 31622400,
    "access_token": "tokenAccess",
    "refresh_token": "tokenRefresh"
}
```

--------------------------------

### POST /api/online/selectOffer

Source: https://epos.unicredit.ro/docs/guides/offers

Finalizes the selection of an offer received from the /api/online/offers endpoint and returns the URL to continue the process on the UniCredit ePOS platform.

```APIDOC
## POST /api/online/selectOffer

### Description
Finalizes the selection of an offer received from the /api/online/offers endpoint and returns the URL to continue the process on the UniCredit ePOS platform.

### Method
POST

### Endpoint
/api/online/selectOffer

### Parameters
#### Request Body
- **sessionID** (string) - Required - The sessionID value provided in the response of the /api/online/offers call.
- **offer_id** (integer) - Required - The offer ID provided in the response of the /api/online/offers call.
- **email_address** (string) - Required - The client's email address for whom the credit application is initiated.

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

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **message** (null) - Additional message information.
- **data** (object) - Contains the sessionUrl.
- **sessionUrl** (string) - The URL to continue the process on the UniCredit ePOS platform.

#### Response Example
{
  "success": true,
  "message": null,
  "data": {
    "sessionUrl": "URL"
  }
}
```

--------------------------------

### Lending Offers API

Source: https://epos.unicredit.ro/docs

Endpoints for retrieving and selecting credit offers.

```APIDOC
## GET /online/offers

### Description
Retrieves available lending offers for the customer.

## POST /online/selectOffer

### Description
Selects a specific credit offer for the current transaction.
```

--------------------------------

### Răspuns logout

Source: https://epos.unicredit.ro/docs/guides/authentication

Confirmarea succesului operațiunii de logout.

```json
{
    "message": "Successfully logged out"
}
```

--------------------------------

### Apel refreshToken

Source: https://epos.unicredit.ro/docs/guides/authentication

Endpoint pentru obținerea unui nou token de acces folosind refresh token-ul.

```http
POST /api/online/refreshToken
Content-Type: application/json
RefreshToken: <refreshToken>
```

--------------------------------

### Autorizare apeluri API

Source: https://epos.unicredit.ro/docs/guides/authentication

Antetul necesar pentru endpoint-urile care necesită autorizare.

```http
Authorization: Bearer <access_token>
```

--------------------------------

### Authentication API

Source: https://epos.unicredit.ro/docs

Endpoints for managing API authorization using Bearer tokens.

```APIDOC
## Authentication Endpoints

### Description
Endpoints used to manage session authorization via Bearer tokens.

### Methods
- POST /login
- POST /refreshToken
- POST /logout
```

--------------------------------

### Apel logout

Source: https://epos.unicredit.ro/docs/guides/authentication

Endpoint pentru invalidarea sesiunii curente.

```http
POST /api/online/logout
Content-Type: application/json
Authorization: Bearer <AccessToken>
```

--------------------------------

### POST /api/online/refreshToken

Source: https://epos.unicredit.ro/docs/guides/authentication

Refreshes the current access token using a valid refresh token.

```APIDOC
## POST /api/online/refreshToken

### Description
Uses the refresh token to obtain a new access token.

### Method
POST

### Endpoint
/api/online/refreshToken

### Parameters
#### Request Header
- **RefreshToken** (string) - Required - The refresh token received from the login response.

### Response
#### Success Response (200)
- **token_type** (string) - The type of token (Bearer).
- **expires_in** (integer) - Expiration time in seconds.
- **access_token** (string) - The new access token.
- **refresh_token** (string) - The new refresh token.

#### Response Example
{
    "token_type": "Bearer",
    "expires_in": 31622400,
    "access_token": "tokenAccess",
    "refresh_token": "tokenRefresh"
}
```

--------------------------------

### POST /api/online/logout

Source: https://epos.unicredit.ro/docs/guides/authentication

Invalidates the current session and logs the user out.

```APIDOC
## POST /api/online/logout

### Description
Logs the user out and invalidates the current session.

### Method
POST

### Endpoint
/api/online/logout

### Parameters
#### Request Header
- **Authorization** (string) - Required - Bearer <AccessToken>

### Response
#### Success Response (200)
- **message** (string) - Confirmation message.

#### Response Example
{
    "message": "Successfully logged out"
}
```
Tokens:
Raw