Płatności w aplikacji z Lovable, Bolt lub v0: jak je dodać
Jak dodać płatności BLIK i kartą do aplikacji zbudowanej w Lovable, Bolt, v0 albo Cursorze: link płatności, sprawdzanie dostępu, webhooki i gotowy prompt.
Ecomfly · · 5 min czytania
Spis treści
Krótka odpowiedź
Aplikację zbudowaną w Lovable, Bolt, v0 czy Cursorze możesz wyposażyć w płatności na dwa sposoby: zbudować własny checkout na Stripe albo podpiąć gotowy link płatności z platformy sprzedażowej. Dla większości twórców drugi sposób jest szybszy i bezpieczniejszy, bo generator kodu nie musi pisać obsługi kart, subskrypcji, zwrotów ani faktur.
W Ecomfly wygląda to tak: tworzysz produkt, przycisk „Kup” w aplikacji otwiera link https://www.ecomfly.shop/c/<slug>, kupujący płaci BLIK-iem, kartą lub przez Przelewy24, a Twoja aplikacja sprawdza dostęp przez API albo webhooki.
Dlaczego nie warto prosić AI o własny checkout?
Generatory aplikacji chętnie napiszą integrację ze Stripe w kilka minut. Problem zaczyna się później. Własny checkout to także:
- obsługa nieudanych płatności i ponowień przy subskrypcjach,
- zwroty i odbieranie dostępu po zwrocie,
- faktury z polskimi danymi i NIP-em kupującego,
- maile z potwierdzeniem i informacją o odnowieniu,
- weryfikacja podpisów webhooków, żeby nikt nie podrobił „opłaconego” zamówienia,
- klucze, które łatwo przypadkiem wysłać do przeglądarki.
Każdy z tych punktów to miejsce, w którym kod wygenerowany przez AI może mieć błąd, którego nie zauważysz do pierwszej reklamacji. Gotowy link płatności przenosi tę odpowiedzialność na platformę.
Własny Stripe czy gotowy link płatności: porównanie
| Kryterium | Własna integracja Stripe | Link płatności Ecomfly |
|---|---|---|
| Czas wdrożenia | Od kilku godzin do kilku dni | Jeden przycisk i jedno zapytanie API |
| BLIK, Przelewy24, karta | Konfigurujesz sam w Stripe | Na stronie płatności od razu |
| Subskrypcje i raty | Piszesz logikę sam | Wbudowane |
| Faktury | Osobne narzędzie | PDF z Ecomfly albo inFakt |
| Wygląd checkoutu | Pełna kontrola | Strona płatności Ecomfly, bez osadzania w ramce |
| Waluty | Dowolne obsługiwane przez Stripe | Tylko PLN |
| Koszt | Opłaty Stripe | Opłaty Stripe plus prowizja Ecomfly (5% bez planu, 1 do 3% w planach) |
Pieniądze w obu przypadkach trafiają na Twoje konto Stripe: Ecomfly działa na Stripe Connect, więc to Ty jesteś stroną umowy ze Stripe.
Kiedy wybrać własną integrację Stripe, a kiedy Ecomfly?
Wybierz własną integrację Stripe, gdy sprzedajesz globalnie w wielu walutach, potrzebujesz checkoutu wbudowanego w interfejs aplikacji albo rozliczeń za zużycie (np. za liczbę zapytań). Wtedy Ecomfly, który sprzedaje tylko w złotych i otwiera checkout jako osobną stronę, będzie ograniczeniem.
Wybierz Ecomfly, gdy sprzedajesz głównie w Polsce, chcesz BLIK-a i faktur bez pisania kodu, a Twoja aplikacja potrzebuje tylko odpowiedzi na pytanie: czy ten e-mail ma dostęp.
Krok 1: Utwórz produkt i skopiuj link płatności
W panelu Ecomfly dodaj produkt jednorazowy albo subskrypcję (co miesiąc lub co rok). Każdy produkt ma link płatności, który skopiujesz przyciskiem „Kopiuj link do płatności” w sekcji Produkty. Jeśli masz kilka pakietów (np. Basic i Pro), dodaj warianty cen: link do konkretnego wariantu ma dopisek ?price= z identyfikatorem opcji. Więcej: Warianty cen i dostępność.
Krok 2: Podepnij przycisk Kup pod link
Przycisk w aplikacji otwiera link w tej samej albo nowej karcie. Checkout nie działa w ramce iframe na obcej domenie, co jest zabezpieczeniem płatności, a nie błędem. Kupujący nie musi zakładać konta w Ecomfly: podaje e-mail przy płatności i po tym e-mailu aplikacja go rozpozna.
Krok 3: Wygeneruj token API i trzymaj go na serwerze
W Ustawienia, API & MCP wygeneruj token. To sekret: zapisz go jako zmienną środowiskową po stronie serwera, np. w Supabase Edge Function, której używa Lovable. Nigdy nie umieszczaj go w kodzie przeglądarki. Endpoint i tak nie odpowiada przeglądarkom, więc próba wywołania go z frontendu się nie uda.
Krok 4: Sprawdzaj dostęp po stronie serwera
Gdy zalogowany użytkownik otwiera płatną funkcję, serwer pyta GET /api/v1/access z jego e-mailem i slugiem produktu. Odpowiedź zawiera pole access: true albo false oraz szczegóły, np. status subskrypcji i datę kolejnej płatności. Zasady:
- produkt jednorazowy daje dostęp po opłaceniu, a zwrot go odbiera,
- subskrypcja daje dostęp, dopóki jest aktywna (także gdy Stripe ponawia nieudaną płatność),
- raty dają dostęp, dopóki plan nie skończy się z niespłaconą ratą.
Pełna specyfikacja z przykładem odpowiedzi: Płatności w Twojej aplikacji.
Krok 5: Opcjonalnie dodaj webhooki
Jeśli wolisz reagować od razu, dodaj adres webhooka w ustawieniach. Ecomfly wyśle zdarzenia o opłaconym zamówieniu, zwrocie, starcie i końcu subskrypcji oraz o ratach. Każde żądanie ma podpis HMAC, który aplikacja musi sprawdzić przed użyciem danych. Webhook może przyjść więcej niż raz, dlatego rozpoznawaj powtórki po identyfikatorze zamówienia lub subskrypcji, a przy logowaniu i tak sprawdzaj dostęp przez API.
Krok 6: Zrób prawdziwy zakup
W Ecomfly nie ma trybu testowego: pierwsza płatność jest prawdziwa. Kup własny produkt, sprawdź, czy aplikacja odblokowała funkcję, potem zrób zwrot w panelu i sprawdź, czy dostęp zniknął.
Gotowy prompt do Lovable, Bolt, v0 albo Cursora
Wklej do swojego narzędzia i podmień slug:
Dodaj płatności przez Ecomfly. Przycisk Kup otwiera link https://www.ecomfly.shop/c/<slug>. Nie buduj własnego checkoutu ani koszyka. Dostęp do płatnych funkcji sprawdzaj po stronie serwera: GET https://www.ecomfly.shop/api/v1/access?email=<e-mail zalogowanego użytkownika>&product=<slug> z nagłówkiem Authorization: Bearer i tokenem z sekretu ECOMFLY_API_TOKEN. Dostęp jest, gdy odpowiedź ma access: true. Nigdy nie wysyłaj tokenu do przeglądarki.
Pełną wersję promptu z webhookami znajdziesz w dokumentacji. Możesz też podłączyć Ecomfly do Claude lub Cursora przez MCP i poprosić agenta, żeby sam założył produkt i link płatności (MCP w e-commerce).
Najczęstsze błędy w aplikacjach z AI
- Token API w kodzie frontendu. Każdy odwiedzający może go wtedy odczytać.
- Dostęp sprawdzany tylko w przeglądarce. Ukrycie przycisku nie chroni funkcji: sprawdzaj na serwerze.
- Brak obsługi zwrotów. Bez sprawdzania dostępu przy logowaniu ktoś, kto dostał zwrot, nadal korzysta z aplikacji.
- Inny e-mail przy zakupie i przy logowaniu. Napisz na stronie zakupu, żeby kupujący użył tego samego adresu, co w aplikacji.
Od czego zacząć
Jeśli zastanawiasz się, jak wycenić i sprzedawać samą aplikację, przeczytaj Jak sprzedawać dostęp do aplikacji lub narzędzia online. Gdy masz już aplikację, załóż konto w Ecomfly, dodaj produkt i podłącz Stripe (Jak połączyć Stripe). Start jest bez abonamentu.
Najczęstsze pytania
Nie w ramce iframe. Ze względów bezpieczeństwa strona płatności otwiera się jako osobna strona Ecomfly, w tej samej albo nowej karcie. Po płatności możesz przekierować kupującego na własną stronę podziękowania.
Zbuduj swój biznes online w Ecomfly.