Przegląd

Zawiera komplet informacji potrzebnych do rozpoczęcia integracji z Comfino — klucze, środowiska i wybór ścieżki wdrożenia.

Szybki start

Comfino udostępnia klientom Twojego sklepu płatności odroczone i finansowanie ratalne. Integracja sprowadza się do przekazania koszyka do Comfino, przekierowania klienta na formularz wniosku i odebrania decyzji kredytowej na wskazany przez Ciebie adres.

Ta sekcja zbiera w jednym miejscu minimum potrzebne do startu. Pełne opisy endpointów i parametrów znajdziesz w dokumentacji API.

Jak działa przepływ

Przekazanie koszyka wraz z danymi użytkownika przez API Comfino.
Przejście na formularz wniosku na podstawie linku w odpowiedzi z API Comfino.
Po wypełnieniu formularza klient otrzymuje najlepszą ofertę kredytu i po jej wybraniu wniosek trafia do instytucji finansowej.
Komunikat przyznania kredytu jest przekazywany jako wywołanie adresu sklepu ze statusem i informacją o wniosku.

Pełny diagram przepływu zamówienia znajdziesz w sekcji Wartości słownikowe.

Wybierz ścieżkę

Własna integracja API

Sklep na własnym silniku lub platforma bez gotowego modułu. Sześć kroków od klucza API do odebrania decyzji kredytowej.

Wtyczka lub platforma SaaS

Magento, PrestaShop, WooCommerce lub jedna z ośmiu platform SaaS. Instalacja modułu i wpisanie kluczy — bez pisania kodu.

Klucze

Podczas rejestracji sklepu Comfino przydziela dwa klucze. Zapisz oba — w razie ich utraty skontaktuj się z Comfino.pl.

Klucz	Gdzie się go używa	Do czego służy
`apiKey`	nagłówek `Api-Key` w każdym żądaniu REST	Uwierzytelnianie wywołań API oraz weryfikacja podpisu notyfikacji.
`widgetKey`	pole `widgetKey` w konfiguracji widgetu JavaScript	Pobieranie ofert przez widget Comfino osadzony na stronie produktu.

Klucze zwracane są w odpowiedzi metody tworzenia użytkownika.

Środowiska

Integrację zaczynasz zawsze na środowisku testowym (sandbox) i przełączasz na produkcyjne dopiero po testach end-to-end.

Środowisko	Host API	Host skryptu widgetu
Testowe (sandbox)	`https://api-ecommerce.craty.pl`	`https://widget.craty.pl/v2/widget-frontend.min.js`
Produkcyjne	`https://api-ecommerce.comfino.pl`	`https://widget.comfino.pl/v2/widget-frontend.min.js`

Każde środowisko ma własną parę kluczy — klucz sandbox nie zadziała na produkcji.

Jeśli Twój firewall filtruje ruch przychodzący, dodaj adresy IP Comfino do białej listy, inaczej notyfikacje o statusie nie dotrą do sklepu. Adresy i przykład konfiguracji: Filtrowanie IP.

Zanim zaczniesz

Kwoty zawsze w groszach Wszystkie kwoty przesyłane do API muszą być liczbami całkowitymi (int) wyrażonymi w groszach — 1 PLN = 100 groszy. Kwota 150000 oznacza 1500,00 zł. Przekazanie wartości zmiennoprzecinkowej lub kwoty w złotych skończy się błędem walidacji 400 Bad Request.

Jeden nagłówek uwierzytelniający Uwierzytelnianie sprowadza się do jednego klucza — bez dodatkowych przepływów autoryzacyjnych do wdrożenia. Każde żądanie REST wymaga nagłówków Content-Type: application/json oraz Api-Key: {API-KEY}. Szczegóły: Uwierzytelnienie.

Krok po kroku: API

Opisuje minimalną ścieżkę wdrożenia własnej integracji z REST API Comfino — od klucza po odebranie decyzji kredytowej.