Szybki start

Krok po kroku: wtyczka lub SaaS

Opisuje uruchomienie Comfino na gotowym module sklepowym lub platformie SaaS, bez własnej integracji z API.

Krok po kroku: wtyczka lub platforma SaaS

Jeśli Twój sklep działa na Magento, PrestaShop, WooCommerce albo jednej z obsługiwanych platform SaaS, nie musisz nic programować. Integracja sprowadza się do instalacji modułu i wpisania kluczy.

Moduły do samodzielnej instalacji

Magento 2.3

Moduł do pobrania wraz z instrukcją instalacji i aktualną wersją.

PrestaShop

Moduł do pobrania wraz z instrukcją instalacji i aktualną wersją.

WooCommerce

Moduł do pobrania wraz z instrukcją instalacji i aktualną wersją.

Przebieg instalacji

Pobierz moduł

Wejdź na stronę swojej platformy powyżej i pobierz najnowszą wersję modułu. Strony pobierają numer wersji i plik bezpośrednio z repozytoriów Comfino na GitHubie, więc zawsze znajdziesz tam aktualne wydanie.

Zainstaluj moduł w sklepie

Postępuj zgodnie z instrukcją instalacji na stronie modułu — sposób wgrania różni się między platformami. Po instalacji aktywuj metodę płatności Comfino w konfiguracji sklepu.

Wpisz klucze i wybierz środowisko

W konfiguracji modułu podaj apiKey oraz widgetKey i ustaw tryb testowy (sandbox). Pamiętaj, że klucze sandbox i produkcyjne to dwie różne pary — patrz Środowiska.

Skonfiguruj widget

Wskaż miejsce na stronie produktu, w którym ma się pojawić kalkulator rat, oraz typy ofert do promowania. Moduły robią to przez formularz konfiguracji — nie trzeba edytować szablonów.

Wykonaj zamówienie testowe

Przejdź pełną ścieżkę zakupu na sandboxie i sprawdź, czy status zamówienia w sklepie zmienia się po decyzji kredytowej. Dopiero potem przechodź do uruchomienia produkcyjnego.

Platformy SaaS

Na tych platformach nie instalujesz modułu — integracja jest już wbudowana, a Comfino włącza się w panelu sklepu lub przez operatora platformy.

cStore

Sellingo

RedCart

SOTE

Shoper

ShopGold

GoShop

TrisoShop

Każda strona platformy zawiera link do instrukcji integracji prowadzonej przez jej operatora. Klucze apiKey i widgetKey otrzymasz od Comfino tak samo jak przy integracji własnej.

Sam widget, bez modułu

Jeśli chcesz jedynie pokazywać wysokość raty na stronie produktu — na przykład zanim wdrożysz pełną płatność — wystarczy osadzić widget. Poniżej konfiguracja z wyłącznie wymaganymi parametrami:

const script = document.createElement('script');
script.onload = function () {
    ComfinoWidgetFrontend.init({
        widgetKey: 'WIDGET_KEY',
        priceSelector: 'span[itemprop=price]',
        widgetTargetSelector: 'div.product-actions',
        type: 'standard',
        offerTypes: ['INSTALLMENTS_ZERO_PERCENT']
    });
};
script.src = '//widget.craty.pl/v2/widget-frontend.min.js';
script.async = true;
document.getElementsByTagName('head')[0].appendChild(script);

Selektory priceSelector i widgetTargetSelector musisz dopasować do szablonu swojego sklepu. Powyższy przykład wskazuje na sandbox — na produkcji podmień host skryptu na widget.comfino.pl.

Pełna konfiguracja widgetu, parametry dodatkowe i funkcje zwrotne →

Co dalej

Testy i uruchomienie

Checklista przejścia z sandboxa na produkcję i lista najczęstszych błędów.

Własna integracja API

Chcesz pełnej kontroli nad przebiegiem integracji? Zobacz ścieżkę REST API.