ekoszykWejdź do panelu
Dokumentacja

Jak podpiąć koszyk — krok po kroku

Przewodnik dla każdego — bez wiedzy programistycznej. Jeśli kiedykolwiek udało Ci się wkleić kawałek kodu na swoją stronę (np. licznik odwiedzin albo czat), tu też dasz radę. Całość to zwykle 30–60 minut.

Zanim zaczniesz — przyda się:
  • możliwość edycji swojej strony (dostęp do panelu WordPressa, Webflow itp.),
  • konto u operatora płatności (Stripe, Przelewy24 lub PayU) — albo chęć założenia go za darmo,
  • lista tego, co chcesz sprzedawać, z cenami.
    1. Załóż konto i sklep2. Dodaj produkty3. Podłącz płatności4. Wklej jeden skrypt na stronę5. Oznacz przyciski „dodaj do koszyka”6. Opublikuj regulamin i politykę prywatności7. Uzupełnij dane firmy8. Przetestuj na niby9. Włącz prawdziwą sprzedaż
1

Załóż konto i sklep

Wejdź do panelu ekoszyk i utwórz konto (e-mailem albo Google). Po zalogowaniu zakładasz swój sklep — wpisujesz jego nazwę i gotowe. To w panelu robisz wszystko: dodajesz produkty, podłączasz płatności i kopiujesz kod do wklejenia.

Na start sklep działa w trybie testowym — możesz spokojnie wszystko poustawiać i poklikać, zanim ruszy prawdziwa sprzedaż. Żadne pieniądze jeszcze nie płyną.

2

Dodaj produkty

W panelu otwórz sekcję Produkty i dodaj to, co sprzedajesz — nazwę i cenę. Możesz mieć warianty (np. rozmiary albo „wersja PDF / wersja drukowana”), każdy z własną ceną.

Dla każdego produktu panel wygeneruje gotowy kawałek kodu z prawdziwym identyfikatorem — to ten kod skopiujesz na swoją stronę w kroku 5. Nie musisz nic w nim rozumieć ani przepisywać ręcznie: jest przycisk „Kopiuj”.

Cena, którą klient faktycznie zapłaci, zawsze pochodzi z panelu — nie z kodu na stronie. Dzięki temu nikt nie „podmieni” ceny w przeglądarce, żeby kupić taniej.

3

Podłącz płatności

Wejdź w sekcję Płatności i podłącz konto operatora, na które mają trafiać pieniądze. Do wyboru:

  • Stripe — najprostszy: klikasz „Podłącz”, logujesz się do Stripe i tyle (BLIK, karty).
  • Przelewy24 lub PayU — wklejasz kilka kluczy ze swojego panelu operatora (panel ekoszyk podpowiada, które pole jest które).

Pieniądze trafiają wprost na Twoje konto u operatora — ekoszyk ich nie dotyka i nie bierze prowizji. Nie masz jeszcze konta? Założysz je za darmo bezpośrednio u operatora.

Na czas testów zaznacz tryb sandbox (testowy) u operatora — przejdziesz całą ścieżkę zakupu na niby. Prawdziwe dane wpiszesz, gdy będziesz gotowy ruszać.

4

Wklej jeden skrypt na stronę

To serce integracji — jedna linijka, którą wklejasz w sekcję <head> swojej strony (albo tuż przed zamknięciem </body>). Wygląda tak:

<script src="https://app.ekoszyk.online/v1/ekoszyk.js" data-store="ID_TWOJEGO_SKLEPU" defer></script>

Swoją prawdziwą wersję (z numerem Twojego sklepu w miejscu ID_TWOJEGO_SKLEPU) skopiujesz jednym kliknięciem z sekcji Widżet w panelu. Po wklejeniu koszyk montuje się sam — nic więcej nie trzeba.

Gdzie to wkleić? Większość systemów ma na to miejsce: WordPress (wtyczka typu „Insert Headers and Footers” albo pole w motywie), Webflow (Project Settings → Custom Code), Wix, Shoper, własny HTML. Skrypt jest lekki i nie psuje wyglądu strony — koszyk jest odizolowany od Twoich stylów.

5

Oznacz przyciski „dodaj do koszyka”

Teraz mówisz koszykowi, które przyciski na stronie mają coś dodawać. Robisz to, wklejając przy produkcie taki przycisk (gotowca z prawdziwym ID weźmiesz z sekcji Produkty):

<button data-ekoszyk-add
  data-ekoszyk-id="ID_WARIANTU"
  data-ekoszyk-name="Nazwa produktu"
  data-ekoszyk-price="49.90"
  data-ekoszyk-currency="PLN">Dodaj do koszyka</button>

Te data-ekoszyk-* to po prostu dopiski w kodzie przycisku, z których koszyk odczytuje, co dodać. Najważniejsze:

DopisekWymagany?Co oznacza
data-ekoszyk-addtakZnacznik, że to przycisk koszyka. Bez wartości — wystarczy, że jest.
data-ekoszyk-idtakIdentyfikator produktu. Skopiuj gotowy z sekcji Produkty — nie wpisuj ręcznie.
data-ekoszyk-nametakNazwa, jaka pojawi się w koszyku, np. „E-book: Zdrowe śniadania”.
data-ekoszyk-pricetakCena w złotówkach, np. 49.90 (kropka lub przecinek — oba działają).
data-ekoszyk-currencyopcjonalnyWaluta. Domyślnie PLN — możesz pominąć.
data-ekoszyk-imageopcjonalnyAdres miniaturki produktu — ładnie wygląda w koszyku.
data-ekoszyk-qtyopcjonalnyIlość sztuk do dodania jednym kliknięciem. Domyślnie 1.

Nie musisz tego pisać z głowy. Skopiuj gotowy przycisk z sekcji Produkty i wklej obok swojego produktu — podmienisz tylko napis „Dodaj do koszyka” na taki, jaki chcesz.

6

Opublikuj regulamin i politykę prywatności

W sekcji Dokumenty znajdziesz gotowe szablony regulaminu i polityki prywatności po polsku. Uzupełniasz je danymi swojego sklepu i publikujesz. Od tej chwili kasa poprosi klienta o akceptację regulaminu i zapamięta, którą wersję zaakceptował — to ważne przy ewentualnych reklamacjach.

Szablony to solidny punkt wyjścia, ale to nie porada prawna — jeśli sprzedajesz coś nietypowego, warto dać tekst do sprawdzenia prawnikowi.

7

Uzupełnij dane firmy

W Ustawieniach wpisz dane swojej firmy (nazwa, NIP, adres) i zaznacz, czy sprzedajesz produkty fizyczne (wtedy kasa zbierze adres wysyłki), czy cyfrowe (pliki, dostępy — kasa poprosi o zgodę na natychmiastowe pobranie).

Jeśli chcesz, by faktury wystawiały się automatycznie, w sekcji Księgowość podłączysz swoją wFirmę albo Fakturownię — faktura wyjdzie wtedy z Twoich ksiąg, z Twoją numeracją.

8

Przetestuj na niby

Zanim ruszysz, zrób sobie próbny zakup. Wejdź na swoją stronę, dodaj produkt do koszyka, przejdź do kasy i „zapłać” w trybie testowym operatora. Sprawdź, czy:

  • przycisk dodaje właściwy produkt i cenę,
  • kasa pokazuje regulamin i pyta o e-mail,
  • po „zapłaceniu” dostajesz potwierdzenie, a zamówienie pojawia się w panelu.

Jeśli coś nie gra — zajrzyj niżej do najczęstszych problemów.

9

Włącz prawdziwą sprzedaż

Gdy test wygląda dobrze, przełączasz sklep na żywo. Potrzebne są dwie rzeczy:

  • wykupiony plan w sekcji Abonament (kończy tryb testowy),
  • dane operatora płatności przełączone z trybu testowego na produkcyjny (live).

Po spełnieniu obu warunków sprzedaż na żywo włącza się sama. Od teraz pieniądze z zamówień trafiają wprost na Twoje konto, a Ty płacisz tylko stały abonament — bez prowizji od obrotu.

Najczęstsze problemy

Kliknięcie w przycisk nic nie robi+

Najczęściej brakuje znacznika data-ekoszyk-add albo skrypt nie został wklejony na tę stronę. Sprawdź, czy skrypt z kroku 4 jest na stronie z przyciskami i czy przycisk ma dopisek data-ekoszyk-add.

Koszyk dodaje produkt, ale bez nazwy lub ceny+

Upewnij się, że przycisk ma data-ekoszyk-id, data-ekoszyk-name i data-ekoszyk-price. Najprościej: skopiuj gotowy przycisk z sekcji Produkty zamiast pisać własny.

W kasie nie ma pola na e-mail albo brak regulaminu+

E-mail pojawia się przy operatorach, które go wymagają (Przelewy24, PayU). Akceptacja regulaminu pojawia się dopiero po opublikowaniu dokumentów w sekcji Dokumenty (krok 6).

„Sprzedaż na żywo jest wyłączona”+

To znaczy, że sklep jest jeszcze w trybie testowym. Wykup plan w sekcji Abonament i przełącz operatora płatności na tryb produkcyjny (krok 9).

Nie chcesz robić tego sam?

Podłączymy koszyk za Ciebie albo zrobimy całą stronę pod klucz.

Zobacz wdrożenie pod klucz
Pełne FAQ Masz pytanie? Napisz do nas