API produktów finansowych

API Endpoints

Kredyty gotówkowe i konsolidacyjne

Dostępne parametry:

 amount                  ->   opis: Kwota pożyczki
                              akceptowane wartości: Tylko liczby całkowite
                              wartość domyślna: 20000

 period                  ->   opis: Okres kredytowania w miesiącach
                              akceptowane wartości: Tylko liczby całkowite
                              wartość domyślna: 48

 payment_type            ->   opis: Rodzaje rat bankowych
                              akceptowane wartości: 's' = równe, 'm' = malejące, 'o' = równe i malejące
                              wartość domyślna: s

 cross_selling           ->   opis: Oferta innych produktów banku w celu obniżenia marży
                              akceptowane wartości: True/False ( True - bez oferty wiązanej,
                                                                 False - z ofertą wiązaną)
                              wartość domyślna: None

 without_certificate     ->   opis: Pożyczka bez zaświadczeń
                              akceptowane wartości: True/False ( True - bez zaświadczeń,
                                                    False - z zaświadczeniem)
                              wartość domyślna: None

 without_insurance       ->   opis: Pożyczka bez ubezpieczenia.
                              akceptowane wartości: True/False ( True - bez ubezpieczenia,
                                                    False - z ubezpieczeniem)
                              wartość domyślna: None


 without_protection      ->   opis: Pożyczka bez zabezpieczeń.
                              akceptowane wartości: True/False ( True - bez zabezpieczeń,
                                                    False - z zabezpieczeniem)
                              wartość domyślna: None


 without_spouse_agree    ->   opis: Pożyczka bez zgody współmałżonka.
                              akceptowane wartości: True/False ( True - bez zgody współmałżonka,
                                                    False - ze zgodą współmałżonka)
                              wartość domyślna: None

Dane w odpowiedzi:

logo_url                 ->   Link do logo banku.

logo_url_format          ->   Link do logo banku w rozmiarze 150x62.

aprc                     ->   Roczna rzeczywista stopa oprocentowania.

total_amount             ->   Całkowita kwota do spłaty.

first_installment        ->   Wysokość pierwszej raty.

product_name             ->   Nazwa produktu.

bank_name                ->   Nazwa banku.

product_id               ->   Identyfikator produktu.

version_id               ->   Wersja identyfikatora produktu.

commission_amount        ->   Kwota prowizji banku.

commission_percent       ->   Procent prowizji banku.

type_of_installments     ->   Rodzaj rat.

without_protection       ->   Kredyt bez zabezpieczenia.

loan_for_a_statement     ->   Kredyt na oświadczenie.

without_spouse_agree     ->   Kredyt bez zgody współmałżonka.

insurance                ->   Ubezpieczenie kredytu.

cross_selling            ->   Oferta wiązana.

ecommerce                ->   Identyfikator produktu e-commerce.

period                   ->   Okres kredytowania w miesiącach.

amount                   ->   Kwota pożyczki.

schedule                 ->   Harmonogram spłat.

lead_url                 ->   Link do produktu.

product_details          ->   Szczegóły dotyczące produktu.

representative_example   ->   Przykład reprezentatywny.

nominal_interest_rate    ->   Wartość oprocentowania nominalnego.

amount_min               ->   Minimalna kwota pożyczki.

amount_max               ->   Maksymalna kwota pożyczki.

period_min               ->   Minimalny okres kredytowania w miesiącach.

period_max               ->   Maksymalny okres kredytowania w miesiącach.

Przykładowa odpowiedź

json [ { "logo_url": "https://galeria.bankier.pl/p/5/d/d4a120b1de2ba3-540-210-297-210-810-315.jpg", "logo_url_format": "https://www.bankier.pl/static_sp/images/l/pko.gif", "aprc": 9.8, "total_amount": 24067.81, "first_installment": 501, "product_name": "Pożyczka gotówkowa na 48 m-cy", "bank_name": "PKO Bank Polski", "product_id": 228, "version_id": 1159, "commission_amount": 0, "commission_percent": 0, "type_of_installments": "równe", "without_protection": null, "loan_for_a_statement": null, "without_spouse_agree": null, "insurance": null, "cross_selling": 0, "ECOMMERCE_product_id": 184, "period": 48, "amount": 20000, "schedule": null, "lead_url": "/e/lead/123?source=lt", "product_details": null, "representative_example": "Rzeczywista Roczna Stopa Oprocentowania (RRSO) wynosi 9,82%, całkowita kwota kredytu (bez kredytowanych kosztów) 32 500,00 zł, całkowita kwota do zapłaty 39 117,85 zł oprocentowanie zmienne 9,39% całkowity koszt kredytu 6 617,85 zł (w tym: prowizja 0,00 zł, odsetki 6 617,85 zł), 47 miesięcznych rat równych po 814,80 zł i ostatnia rata: 822,25 zł. Kalkulacja została dokonana na dzień 27.10.2022 r. na reprezentatywnym przykładzie.", "nominal_interest_rate": 10.99, "amount_max": 230000, "amount_min": 1000, "period_min": 6, "period_max": 60 } ]

Konta osobiste

Dane w odpowiedzi:

product_name            ->   Nazwa konta osobistego.

bank_name               ->   Nazwa banku.

logo_url                ->   Link do logo banku.

logo_url_format         ->   Link do logo banku w rozmiarze 150x62.

ecommerce               ->   Identyfikator produktu e-commerce.

product_id              ->   Identyfikator produktu.

management_fee_min      ->   Minimalna opłata za prowadzenie konta.

management_fee_max      ->   Maksymalna opłata za prowadzenie konta.

management_fee_exempting_conditions -> Warunki zwolnienia z opłat za prowadzenie konta.

external_outgoing_transfer_fee_min  -> Minimalna opłata za przelew wychodzący zewnętrzny.

external_outgoing_transfer_fee_max  -> Maksymalna opłata za przelew wychodzący zewnętrzny.

bonus                   ->   Premia oferowana za otwarcie konta.

bonus_opis              ->   Szczegóły dotyczące premii.

debit_cards             ->   Dane dotyczące kart debetowych powiązanych z kontem (typ karty, opłaty, sieć darmowych bankomatów, funkcje karty).

                            domestic_atm_fee        -> Opłata za wypłatę z bankomatu krajowego.

                            domestic_atm_fee_min    -> Minimalna opłata za wypłatę z bankomatu krajowego.

                            domestic_atm_fee_max    -> Maksymalna opłata za wypłatę z bankomatu krajowego.

                            domestic_atm_fee_exempting_conditions -> Warunki zwolnienia z opłaty za wypłatę z bankomatu krajowego.

                            free_withdrawal_domestic_atm -> Wskazuje, czy wypłaty z bankomatów krajowych są darmowe.

                            atm_free_network        -> Informacje o sieciach bankomatów, w których wypłaty są darmowe.

                            debit_card_fixed_fee_min -> Minimalna stała opłata za kartę debetową.

                            debit_card_fixed_fee_max -> Maksymalna stała opłata za kartę debetową.

                            debit_card_fixed_fee_exempting_conditions -> Warunki zwolnienia z opłat stałych za kartę.

                            free_withdrawal_foreign_atm -> Wskazuje, czy wypłaty z zagranicznych bankomatów są darmowe.

                            foreign_atm_fee         -> Opłata za wypłatę z zagranicznych bankomatów.

                            foreign_atm_fee_min     -> Minimalna opłata za wypłatę z zagranicznych bankomatów.

                            foreign_atm_fee_max     -> Maksymalna opłata za wypłatę z zagranicznych bankomatów.

                            foreign_atm_fee_exempting_conditions -> Warunki zwolnienia z opłaty za wypłatę z zagranicznych bankomatów.

                            features                -> Funkcje dostępne dla karty debetowej (np. cashback, płatności zbliżeniowe).

                            name                    -> Nazwa karty debetowej.

features                ->   Funkcje konta osobistego (np. Aplikacja mobilna, Google Pay, Apple Pay).

lead_url                ->   Link do produktu.

product_details         ->   Szczegóły dotyczące produktu.

Przykładowa odpowiedź

json [ { "product_name": "Konto Santander", "bank_name": "Santander Bank Polska", "logo_url": "https://galeria.bankier.pl/p/9/1/0e5115eda561a9.png?16", "logo_url_format": "https://www.bankier.pl/static_sp/images/l/santanderbankpolska.gif", "ecommerce": 2765, "product_id": 104, "management_fee_min": 0, "management_fee_max": 6, "management_fee_exempting_conditions": "* 0 zł, jeśli dokonano płatności kartą lub Blikiem na min. 300 zł", "external_outgoing_transfer_fee_min": 0, "external_outgoing_transfer_fee_max": 0, "bonus": "1200 zł", "bonus_opis": "500 zł + 100 zł premii za otwarcie konta i aktywność na nim
\r\n100 zł z Programem Poleceń
\r\n300 zł zwrotu za zapłacone rachunki
\r\n200 zł za konto dla dziecka z kartą debetową i płatnością kartą", "debit_cards": [ { "name": "Karta Dopasowana Mastercard/Visa", "domestic_atm_fee": 3.0, "domestic_atm_fee_min": 0.0, "domestic_atm_fee_max": 3.0, "domestic_atm_fee_exempting_conditions": "0 zł, jeśli klient wykupił pakiet darmowych wypłat z bankomatów za 5 zł/m-c", "free_withdrawal_domestic_atm": false, "atm_free_network": [ { "id": 15, "name": "Santander Bank Polska" } ], "debit_card_fixed_fee_min": 0.0, "debit_card_fixed_fee_max": 9.0, "debit_card_fixed_fee_exempting_conditions": "* 0 zł, jeśli dokonano płatności kartą lub Blikiem na min. 300 zł", "free_withdrawal_foreign_atm": false, "foreign_atm_fee": 10.0, "foreign_atm_fee_min": 0.0, "foreign_atm_fee_max": 10.0, "foreign_atm_fee_exempting_conditions": "0 zł, jesli klient wykupił pakiet darmowych wypłat z bankomatów za 5 zł/m-c", "features": [ [ 1, "Płatności internetowe" ], [ 3, "Płatności zbliżeniowe" ], [ 4, "Cash back" ] ] } ], "features": [ [ 8, "Google Pay" ], [ 1, "Aplikacja mobilna" ], [ 7, "NFC" ], [ 6, "Blik" ], [ 9, "Apple Pay" ] ], "lead_url": "/e/lead/2382?source=api-konta-osobiste", "product_details": "https://api.systempartnerski.pl/publishers/financial-products-api/product_details?&product_id=104" }, ]

Konta firmowe

Dane w odpowiedzi:

product_name            ->   Nazwa konta firmowego.

bank_name               ->   Nazwa banku.

logo_url                ->   Link do logo banku.

logo_url_format         ->   Link do logo banku w rozmiarze 150x62.

ecommerce               ->   Identyfikator produktu e-commerce.

product_id              ->   Identyfikator produktu.

management_fee_min      ->   Minimalna opłata za prowadzenie konta.

management_fee_max      ->   Maksymalna opłata za prowadzenie konta.

management_fee_exempting_conditions -> Warunki zwolnienia z opłat za prowadzenie konta.

external_outgoing_transfer_fee_min  -> Minimalna opłata za przelew wychodzący zewnętrzny.

external_outgoing_transfer_fee_max  -> Maksymalna opłata za przelew wychodzący zewnętrzny.

bonus                   ->   Premia oferowana za otwarcie konta.

bonus_opis              ->   Szczegóły dotyczące premii.

debit_cards             ->   Dane dotyczące kart debetowych powiązanych z kontem (typ karty, opłaty, sieć darmowych bankomatów, funkcje karty).

                            domestic_atm_fee        -> Opłata za wypłatę z bankomatu krajowego.

                            domestic_atm_fee_min    -> Minimalna opłata za wypłatę z bankomatu krajowego.

                            domestic_atm_fee_max    -> Maksymalna opłata za wypłatę z bankomatu krajowego.

                            domestic_atm_fee_exempting_conditions -> Warunki zwolnienia z opłaty za wypłatę z bankomatu krajowego.

                            free_withdrawal_domestic_atm -> Wskazuje, czy wypłaty z bankomatów krajowych są darmowe.

                            atm_free_network        -> Informacje o sieciach bankomatów, w których wypłaty są darmowe.

                            debit_card_fixed_fee_min -> Minimalna stała opłata za kartę debetową.

                            debit_card_fixed_fee_max -> Maksymalna stała opłata za kartę debetową.

                            debit_card_fixed_fee_exempting_conditions -> Warunki zwolnienia z opłat stałych za kartę.

                            free_withdrawal_foreign_atm -> Wskazuje, czy wypłaty z zagranicznych bankomatów są darmowe.

                            foreign_atm_fee         -> Opłata za wypłatę z zagranicznych bankomatów.

                            foreign_atm_fee_min     -> Minimalna opłata za wypłatę z zagranicznych bankomatów.

                            foreign_atm_fee_max     -> Maksymalna opłata za wypłatę z zagranicznych bankomatów.

                            foreign_atm_fee_exempting_conditions -> Warunki zwolnienia z opłaty za wypłatę z zagranicznych bankomatów.

                            features                -> Funkcje dostępne dla karty debetowej (np. cashback, płatności zbliżeniowe).

                            name                    -> Nazwa karty debetowej.

lead_url                ->   Link do produktu.

product_details         ->   Szczegóły dotyczące produktu.

features                ->   Funkcje konta (np. Aplikacja mobilna, Google Pay, Apple Pay).

customer_type           ->   Typ klienta.(np. 'jednoosobowa działalność gospodarcza', 'spółka jawna', 'fundacja', 'spółka cywilna', 'spółka partnerska', 'stowarzyszenie rejestrowe'

Przykładowa odpowiedź

json [ { "product_name": "Nest Konto", "bank_name": "Nest Bank", "logo_url": "https://galeria.bankier.pl/p/0/9/4d975395597cc4.png", "logo_url_format": "https://www.bankier.pl/static_sp/images/l/nestbank.gif", "ecommerce": 3022, "product_id": 8, "management_fee_min": 0, "management_fee_max": 0, "management_fee_exempting_conditions": "", "external_outgoing_transfer_fee_min": 0, "external_outgoing_transfer_fee_max": 0, "bonus": "", "bonus_opis": "", "debit_cards": [ { "name": "Visa Business", "domestic_atm_fee": 6.0, "domestic_atm_fee_min": 0.0, "domestic_atm_fee_max": 6.0, "domestic_atm_fee_exempting_conditions": "", "free_withdrawal_domestic_atm": false, "atm_free_network": [ { "id": 1, "name": "Euronet" } ], "debit_card_fixed_fee_min": 0.0, "debit_card_fixed_fee_max": 0.0, "debit_card_fixed_fee_exempting_conditions": "", "free_withdrawal_foreign_atm": false, "foreign_atm_fee": 6.0, "foreign_atm_fee_min": 6.0, "foreign_atm_fee_max": 6.0, "foreign_atm_fee_exempting_conditions": "", "features": [ [ 1, "Płatności internetowe" ], [ 3, "Płatności zbliżeniowe" ], [ 4, "Cash back" ] ] }, { "name": "Visa do Nest Konta", "domestic_atm_fee": 6.0, "domestic_atm_fee_min": 0.0, "domestic_atm_fee_max": 6.0, "domestic_atm_fee_exempting_conditions": "", "free_withdrawal_domestic_atm": false, "atm_free_network": [ { "id": 1, "name": "Euronet" } ], "debit_card_fixed_fee_min": 0.0, "debit_card_fixed_fee_max": 0.0, "debit_card_fixed_fee_exempting_conditions": "", "free_withdrawal_foreign_atm": false, "foreign_atm_fee": 6.0, "foreign_atm_fee_min": 6.0, "foreign_atm_fee_max": 6.0, "foreign_atm_fee_exempting_conditions": "", "features": [ [ 1, "Płatności internetowe" ], [ 3, "Płatności zbliżeniowe" ], [ 4, "Cash back" ] ] } ], "features": [ [ 8, "Google Pay" ], [ 1, "Aplikacja mobilna" ], [ 6, "Blik" ], [ 9, "Apple Pay" ] ], "lead_url": "/e/lead/1562?source=api-konta-osobiste", "product_details": "https://api.systempartnerski.pl/publishers/financial-products-api/product_details?&product_id=8" } ]

Konta oszczędnościowe

Dane w odpowiedzi:

bank_name               ->   Nazwa banku.

logo_url                ->   Link do logo banku.

logo_url_format         ->   Link do logo banku w rozmiarze 150x62.

label                   ->   Opis promocji produktu.

short_label             ->   Krótszy opis promocji produktu.

capitalization          ->   Częstotliwość kapitalizacji (np. '1M' - co miesiąc).

capitalization_mode     ->   Tryb kapitalizacji.

number_of_transfers     ->   Liczba darmowych przelewów.

number_of_transfers_notes -> Uwagi dotyczące liczby przelewów.

product_name            ->   Nazwa konta oszczędnościowego.

interest_rate           ->   Oprocentowanie dla różnych kwot konta (tablica [od jakiej kwoty, oprocentowanie, data obowiazywania]).

product_id              ->   Identyfikator produktu.

version                 ->   Wersja identyfikatora produktu.

maintenance_fee_from    ->   Minimalna opłata za prowadzenie konta.

maintenance_fee_to      ->   Maksymalna opłata za prowadzenie konta.

internal_transfer_fee   ->   Opłata za przelew wewnętrzny.

external_transfer_fee   ->   Opłata za przelew zewnętrzny.

has_checking_account    ->   Czy produkt wymaga posiadania konta osobistego.

conditional             ->   Czy oferta jest warunkowa.

conditional_notes       ->   Uwagi dotyczące warunków oferty.

lead_url                ->   Link do produktu.

product_details         ->   Szczegóły dotyczące produktu.

Przykładowa odpowiedź

json [ { "bank_name": "VeloBank", "logo_url": "https://galeria.bankier.pl/p/9/9/a18b9498b46d59-thumb-200.png?358780", "logo_url_format": "https://www.bankier.pl/static_sp/images/l/velobank.gif", "label": "Do 600 zł premii z kontem osobistym VeloKonto", "short_label": "Do 600 zł premii z kontem osobistym VeloKonto", "capitalization": "1M", "capitalization_mode": null, "number_of_transfers": null, "number_of_transfers_notes": "Bezpłatna pierwsza operacja w miesiącu (wypłata lub przelew). \rBrak opłat za przelewy na lokaty w banku. ", "product_name": "Elastyczne Konto Oszczędnościowe", "interest_rates": [ [ 400000.01, 3.0, "" ], [ 100000.01, 2.0, "" ], [ 1.0, 1.0, "" ] ], "product_id": 62, "version": 177, "maintenance_fee_from": 0.0, "maintenance_fee_to": 0.0, "internal_transfer_fee": 9.0, "external_transfer_fee": 9.0, "has_checking_account": false, "conditional": false, "conditional_notes": "", "lead_url": "/e/lead/1528?source=api-oszczednosciowe", "product_details": "https://api.systempartnerski.pl/publishers/financial-products-api/product_details?&product_id=62" } ]

Lokaty

Dane w odpowiedzi:

version_id              ->   Wersja produktu.

product_name            ->   Nazwa lokaty.

bank_name               ->   Nazwa banku.

min_amount              ->   Minimalna kwota lokaty.

max_amount              ->   Maksymalna kwota lokaty.

currency                ->   Waluta lokaty.

interest_rate           ->   Oprocentowanie dla różnych kwot lokaty (tablica [od jakiej kwoty, oprocentowanie]).

interest_rate_description -> Opis oprocentowania lokaty.

period                  ->   Okres trwania lokaty.

period_description      ->   Opis okresu lokaty.

capital_interest        ->   Czy kapitalizacja jest włączona.

capital_interest_description     ->   Opis kapitalizacji.

ecommerce               ->   Identyfikator produktu e-commerce.

logo_url                ->   Link do logo banku.

logo_url_format         ->   Link do logo banku w rozmiarze 150x62.

access                  ->   Metody dostępu do produktu (np. 'bankowość internetowa', 'wniosek on-line').

account                 ->   Czy wymagane jest posiadanie konta.

account_description     ->   Opis dotyczący wymogu posiadania konta.

interest_type           ->   Typ oprocentowania.

lead_url                ->   Link do produktu.

product_details         ->   Szczegóły dotyczące produktu.

Przykładowa odpowiedź

json [ { "product_id":746, "version_id":2791, "product_name": "Nest Lokata Witaj", "bank_name":"Nest Bank", "min_amount":"1000", "max_amount":"25000", "currency":"PLN", "interest_rate":[[25000,0],[1000,5]], "interest_rate_description":[[null,"5,25"]], "period":"3M", "period_description":"3 miesiące", "capital_interest":false, "capital_interest_description":"3 miesiące", "ecommerce":null, "logo_url":"https://galeria.bankier.pl/p/0/9/4d975395597cc4.png", "logo_url_format":"https://www.bankier.pl/static_sp/images/l/nestbank.gif", "access":["bankowość internetowa","system transakcyjny"], "account":true, "account_description":"", "interest_type":"S", "lead_url":"/e/lead/1727?source=api-lokaty", "product_details":"https://api.systempartnerski.pl/publishers/financial-products-api/product_details?&product_id=746&version_id=2791" } ]

Kredyty hipoteczne

Dostępne parametry:

    amount                  ->   opis: Kwota pożyczki
                              akceptowane wartości: Tylko liczby całkowite
                              wartość domyślna: 400000

    period                  ->   opis: Okres kredytowania w latach
                              akceptowane wartości: Tylko liczby całkowite
                              wartość domyślna: 30

    property_value          ->   opis: Wartość nieruchomości, której dotyczy zapytanie
                                wartość domyślna: 1.25 * amount

Dane w odpowiedzi:

product_name            ->   Nazwa produktu.

bank_name               ->   Nazwa banku oferującego kredyt.

product_id              ->   Identyfikator produktu.

version_id              ->   Wersja identyfikatora produktu.

amount                  ->   Kwota kredytu, o jaką klient wnioskuje klient.

property_value          ->   Wartość nieruchomości, na którą jest udzielany kredyt.

period                  ->   Okres kredytowania w latach.

ecommerce               ->   Identyfikator e-commerce produktu.

product_details         ->   Link do szczegółów dotyczących produktu.

logo_url                 ->   Link do logo banku.

logo_url_format          ->   Link do logo banku w rozmiarze 150x62.

entity                  ->   Typ klienta, np. "stały klient indywidualny".

repayment_type          ->   Rodzaj spłaty kredytu, np. raty stałe lub malejące ("stałe lub malejące").

commission_min          ->   Minimalna prowizja za udzielenie kredytu.

commission_max          ->   Maksymalna prowizja za udzielenie kredytu.

remarks                 ->   Uwagi dotyczące produktu, dodatkowe informacje.

income_sources          ->   Źródła dochodu akceptowane przy wnioskowaniu o kredyt (np. "umowa o pracę czas nieokreślony", "działalność gospodarcza", "emerytura").

representative_example  ->   Przykład reprezentatywny kredytu, zawierający szczegółowe informacje.

real_estate_valuation_amount_from -> Minimalna kwota wartości nieruchomości (np. "400.0").

lead_url                ->   Link do formularza wniosku o produkt (np. "/e/lead/8?source=api-hipoteki").

margin                  ->   Marża banku dla udzielonego kredytu, wyrażona w procentach (np. "1,95").

apr                     ->   Roczna Rzeczywista Stopa Oprocentowania (RRSO), określająca całkowite koszty kredytu w skali roku (np. "7,83").

nominal_interest_rate   ->   Nominalna stopa oprocentowania kredytu.

max_credit_period       ->   Maksymalny okres kredytowania wyrażony w latach.

first_installment       ->   Kwota pierwszej raty pożyczki.

schedule                ->   Ten parametr występuje tylko w widoku szczegółowym produktu. Prezentuje szczegółowy harmonogram spłaty rat.

total_amount            ->   Całkowita kwota do spłaty.

cross_selling           ->   Czy produkt wymaga cross-sellingu, np. dodatkowych produktów finansowych (0 - brak, 1 - wymagany).

cross_selling_list      ->   Lista wymaganych produktów dodatkowych w ramach cross-sellingu (np. "ROR z wpływem na konto", "ubezpieczenie na życie").

purposes                ->   Możliwe cele kredytowania (np. "budowa domu", "zakup działki", "zakup mieszkania lub domu").

insurance               ->   True w przypadku jeśli ubezpieczenie jest wymagane.

fixed_rate              ->   Określa, czy oprocentowanie kredytu jest stałe.

Przykładowa odpowiedź

json [ { "product_name": "Kredyt hipoteczny VeloDom", "bank_name": "VeloBank", "product_id": 23, "version_id": 497, "amount": 400000, "property_value": 500000, "period": 30, "ecommerce": 150, "product_details": "https://api.systempartnerski.pl/publishers/financial-products-api/product_details?amount=400000&period=30&property_value=500000&product_id=23&version_id=497", "logo_url": "https://galeria.bankier.pl/p/9/9/a18b9498b46d59-thumb-200.png?358780", "logo_url_format": "https://www.bankier.pl/static_sp/images/l/velobank.gif", "entity": [ "nowy klient indywidualny", "stały klient indywidualny" ], "repayment_type": "stałe lub malejące", "commission_min": null, "commission_max": null, "remarks": "", "income_sources": [ "umowa o pracę czas nieokreślony", "umowa o pracę czas określony", "działalność gospodarcza", "umowa zlecenie", "umowa o dzieło", "wynajem nieruchomości", "działalność rolnicza", "emerytura", "renta stała", "renta czasowa", "kontrakt", "dochody z zagranicy" ], "representative_example": "Rzeczywista Roczna Stopa Oprocentowania (RRSO) dla kredytu mieszkaniowego z okresowo stałym oprocentowaniem, w VeloBank S.A. zabezpieczonego hipoteką wynosi 8,12%.\r\n\r\nRRSO obliczyliśmy przy następujących założeniach:\r\n\r\n kredyt został wypłacony w całości w jednej transzy,\r\n okres kredytowania: 285 miesięcy,\r\n całkowita kwota kredytu (bez kredytowanych kosztów): 400 000 zł,\r\n LTV (kwota kredytu do wartości zabezpieczenia): 65%,\r\n oprocentowanie stałe w okresie pierwszych 5 lat: 7,14% w skali roku, w dalszym okresie oprocentowanie zmienne wynosi 7,58372% a WIRON 1M Stopa Składana wynosi 4,88372% (według stanu na dzień 15-12-2023 r.),\r\n całkowity koszt kredytu 482 928,92 zł w tym: prowizja: 0 zł, odsetki 453 217,12 zł, podatek od czynności cywilnoprawnych (PCC) 19 zł, usługi dodatkowe: „konto z pakietem” – opłata za prowadzenie konta w banku 0 zł, ubezpieczenie nieruchomości dystrybuowane przez bank – koszt ubezpieczenia w całym okresie kredytowania: 7 039,68 zł, ubezpieczenie VeloBezpieczny dystrybuowane przez bank – koszt ubezpieczenia w całym okresie kredytowania 22 653,12 zł; liczba rat: 285 – raty równe (bez okresu karencji w spłacie) w wysokości 2 918,05 zł w okresie pierwszych 5 lat a od 6 roku po 3 013,94 zł.\r\n całkowita kwota do zapłaty: 882 928,92 zł,\r\n\r\nW RRSO nie uwzględniliśmy kosztu operatu szacunkowego nieruchomości (koszt nieznany bankowi) – usługa zlecana przez klienta we własnym zakresie, niedostępna za pośrednictwem banku. Jeżeli Twój kredyt będzie wypłacony w transzach, dodatkowo poniesiesz koszty inspekcji nieruchomości w wysokości zgodnej z Tabelą Opłat i Prowizji VeloBank S.A. dla kredytów hipotecznych (liczba inspekcji uzależniona jest od liczby transz). Na dzień sporządzenia tego dokumentu koszt jednej inspekcji wynosi 280 zł.\r\n\r\nStałe oprocentowanie kredytu niesie za sobą ryzyko, że wysokość raty może być okresowo wyższa, niż gdyby była ona obliczana na podstawie aktualnego w tym okresie wskaźnika referencyjnego, wykorzystywanego jako indeks w umowie kredytowej (WIRON 1M Stopa Składana).\r\n\r\nWzrost wartości wskaźnika referencyjnego WIRON 1M Stopa Składana w okresie obowiązywania stałej stopy procentowej może prowadzić do wzrostu raty kredytu po zakończeniu tego okresu i przejściu na oprocentowanie zmienne. Po zmianie formuły oprocentowania na oprocentowanie zmienne ponosisz ryzyko zmiennej stopy procentowej, które polega na tym, że w razie wzrostu wartości wskaźnika referencyjnego, wzrośnie oprocentowanie Twojego kredytu, a tym samym wzrośnie wysokość raty oraz łączny całkowity koszt kredytu.\r\n\r\nKalkulację obliczyliśmy na dzień 10.01.2024 r. na reprezentatywnym przykładzie. ", "real_estate_valuation_amount_from": null, "lead_url": "/e/lead/63?source=api-hipoteki", "margin": 2.21, "apr": 8, "nominal_interest_rate": 8.01, "max_credit_period": 30, "first_installment": 2747.72, "total_amount": 1040358, "cross_selling": 1, "cross_selling_list": [ "ROR z wpływem na konto", "ubezpieczenie nieruchomości" ], "purposes": [ "budowa domu", "refinansowanie", "zakup mieszkania lub domu" ], "fixed_rate": true, "insurance": true }, ]

Przykładowe implementacje w PHP

<?php
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://<adres_api>/getdata?amount=20000&period=48&payment_type=s&cross_selling=false&without_certificate=true&without_insurance=false&without_protection=true&without_spouse_agree=false',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Accept: application/json',
    'X-Auth-Token: <dedicated_token>'
  ),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Zmienne:

• CURLOPT_HTTPHEADER, X-Auth-Token -> Miejsce na token autoryzacyjny.

• CURLOPT_URL -> Miejsce na adres URL, na który zostanie wysłane zapytanie.

<?php
$client = new http\Client;
$request = new http\Client\Request;
$request->setRequestUrl('https://<adres_api>/getdata?amount=20000&period=48&payment_type=s&cross_selling=false&without_certificate=true&without_insurance=false&without_protection=true&without_spouse_agree=false');
$request->setRequestMethod('GET');
$request->setOptions(array());
$request->setHeaders(array(
  'Accept' => 'application/json',
  'X-Auth-Token' => '<dedicated_token>'
));
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();
?>

Zmienne:

• $request->setHeaders, X-Auth-Token -> Miejsce na token autoryzacyjny.

• $request->setRequestUrl -> Miejsce na adres URL, na który zostanie wysłane zapytanie.

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://<adres_api>/getdata?amount=20000&period=48&payment_type=s&cross_selling=false&without_certificate=true&without_insurance=false&without_protection=true&without_spouse_agree=false');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
 'Accept' => 'application/json',
 'X-Auth-Token' => '<dedicated_token>'
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
?>

Zmienne:

• $request->setHeader, X-Auth-Token -> Miejsce na token autoryzacyjny.

• $request->setUrl -> Miejsce na adres URL, na który zostanie wysłane zapytanie.

Przykładowe implementacje w Python

import requests

url = "https://<adres_api>/getdata?amount=20000&period=48&payment_type=s&cross_selling=false&without_certificate=true&without_insurance=false&without_protection=true&without_spouse_agree=false"
headers = {
'X-Auth-Token': '<dedicated_token>'
}

response = requests.request("GET", url, headers=headers)
print(response.text)

Zmienne:

• headers -> Miejsce na token autoryzacyjny.

• url -> Miejsce na adres URL, na który zostanie wysłane zapytanie.

import http.client

conn = http.client.HTTPSConnection("<adres_api>")
headers = {
'X-Auth-Token': '<dedicated_token>'
}

conn.request("GET", "/getdata?amount=20000&period=24&cross_selling=true", headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Zmienne:

• headers -> Miejsce na token autoryzacyjny.

• conn -> Miejsce na adres URL, na który zostanie wysłane zapytanie.

Budowanie adresu URL:

Możesz zbudować zapytanie dodając dostępne parametry w postaci klucz = wartość oddzielone znakiem & do adresu URL:

https://<adres_api>/getdata?

Przykłady:

https://<adres_api>/getdata?amount=20000&period=48&without_certificate=false

https://<adres_api>/getdata?amount=35000&period=24&without_protection=true