Integracje / Stripe
Integracja AI ze Stripe
Podłączamy Stripe API i czytamy obiekty PaymentIntent, Charge, Refund, Dispute i BalanceTransaction. Asystent kojarzy każdą wpłatę z zamówieniem, liczy realny przychód po prowizjach i pilnuje terminów sporów.
Rozmowa trwa 15 minut. Dzwonimy my, nic nie trzeba instalować.
Po rozmowie dwa tygodnie za darmo. Jeśli uznamy, że u Was to ma sens, uruchamiamy Wam własną platformę podłączoną pod Stripe. Bez umowy i bez karty.
Czym jest Stripe
Stripe to chmurowa bramka płatnicza, z której korzystają sklepy internetowe, platformy SaaS i firmy sprzedające subskrypcje. Wszystkie dane transakcji przechowywane są wyłącznie w infrastrukturze Stripe, nie na serwerze klienta. Dostęp odbywa się przez REST API albo panel Stripe Dashboard.
Codziennie w Stripe powstają obiekty: PaymentIntent przy każdej próbie płatności, Charge po udanym pobraniu, Refund przy zwrocie, Dispute przy chargebacku i Payout przy przelewie na konto bankowe. Firmy abonamentowe korzystają dodatkowo z modułu Stripe Billing, który tworzy obiekty Subscription i Invoice dla każdego cyklu rozliczeniowego.
Co podłączamy w Stripe
- PaymentIntent i Charge: status oraz historia każdej transakcji
- Dispute z polem evidence: otwarte spory i daty zamknięcia okna
- Payout: wypłaty na konto i ich składowe transakcje
- BalanceTransaction z polem fee: prowizje na poziomie pojedynczej płatności
- Stripe Billing: obiekty Subscription i Invoice z cyklami rozliczeniowymi
Zakres ustalamy pod Was. Zaczynamy od odczytu danych, a zapis i akcje włączamy dopiero wtedy, gdy sami tego chcecie.
O co pytają w praktyce
Pytania zadaje się po polsku, jak koledze z pracy.
„Które wpłaty z tego tygodnia nie pasują do żadnego zamówienia?"
„Ile wyniosły łączne prowizje Stripe w zeszłym miesiącu?"
„Czy mam otwarte spory, na które zaraz mija termin odpowiedzi?"
„Którzy subskrybenci mają status past_due lub wygasłą kartę?"
Co dokładnie podłączamy w Stripe
Obszar po obszarze: jakie dane czytamy i co asystent z nich robi. To lista z realnego wdrożenia, nie katalog możliwości.
Czytamystatus transakcji (succeeded/failed), identyfikator ch_, kwota brutto, waluta, data, pole metadata z numerem zamówienia
AsystentDopasowuje każdą wpłatę do zamówienia lub faktury po wielu sygnałach jednocześnie: OrderID, kwocie, walucie i dacie, nawet gdy kwota różni się o grosz przy zaokrągleniu VAT
Czytamyidentyfikator zwrotu, pole reason, powiązany Charge, kwota i data zwrotu
AsystentMonitoruje wszystkie zwroty na bieżąco i wykrywa sytuację, gdy ten sam klient dostał zwrot dwa razy za to samo zamówienie
Czytamyidentyfikator sporu, status, data zamknięcia okna odpowiedzi, pole evidence z załączonymi dokumentami
AsystentZbiera automatycznie dane transakcji i wysyłki, przygotowuje szkic odpowiedzi z gotowymi faktami i pilnuje terminu na dwa dni przed zamknięciem okna
Czytamyidentyfikator wypłaty, kwota netto, data przelewu na konto, składowe transakcje powiązane z daną wypłatą
AsystentZestawia wypłaty ze składowymi transakcjami i liczy rzeczywisty przychód po prowizjach Stripe za wybrany okres
Czytamykwota brutto transakcji, prowizja fee per transakcja, typ zdarzenia, waluta rozliczeniowa
AsystentSumuje prowizje na poziomie każdej transakcji i buduje bieżące zestawienie kosztu bramki z podziałem na typ i walutę
Czytamystatus subskrypcji (active, past_due, canceled), current_period_end, customer_id, status faktury (paid, open, uncollectible)
AsystentWskazuje klientów z wygasłą kartą (requires_payment_method) oraz tych, których cykl rozliczeniowy kończy się w ciągu najbliższych siedmiu dni
Czytamyzdarzenia charge.dispute.created, pole metadata z numerem zamówienia lub faktury przy każdej transakcji
AsystentReaguje na zdarzenie w momencie wysłania webhooka, nie przy ręcznym sprawdzaniu panelu, co skraca czas reakcji do minut od momentu zdarzenia
Co się zmienia
Księgowość dostaje rano jeden raport z dopasowanymi transakcjami, a spory nie giną między działami, bo powiadomienie trafia do zespołu natychmiast po zdarzeniu charge.dispute.created.
Asystent stoi na Waszym serwerze i łączy się z Stripe na Waszych uprawnieniach. Dane nie wychodzą do zewnętrznych usług, a każdy odczyt i każda akcja zostawiają ślad w logu. Zakres uprawnień ustalacie Wy, więc asystent widzi dokładnie tyle, ile ma widzieć.
Nie wymieniamy Wam programu i nie zmuszamy nikogo do zmiany nawyków. Stripe zostaje tam, gdzie jest, razem z historią danych i przyzwyczajeniami zespołu.
Jak łączymy się z Stripe
Łączymy się z Stripe przez REST API używając klucza ograniczonego (Restricted Key) z uprawnieniami wyłącznie do odczytu. Webhooki rejestrujemy na dedykowanym endpoincie po stronie serwera asystenta. Asystent stoi na serwerze klienta lub w bezpiecznej chmurze zgodnej z RODO. Danych transakcji nie kopiujemy trwale poza środowisko klienta.
Tryb pracy to odczyt. Zapisu do Stripe nie wykonujemy bez jawnego potwierdzenia osoby uprawnionej, dotyczy to też dodawania treści do pola evidence w sporze. Klucz API przechowujemy w zmiennych środowiskowych, nie w plikach konfiguracyjnych. Zakres dostępu można ograniczyć do wybranych zasobów przez uprawnienia Restricted Key.
Czego potrzebujemy od Was
- Klucz Restricted Key Stripe z uprawnieniami do odczytu: PaymentIntent, Charge, Dispute, Payout, Subscription
- Skonfigurowane webhooki w panelu Stripe wysyłające zdarzenia na adres endpointu asystenta
- Pole metadata przy każdej transakcji zawierające numer zamówienia lub faktury z systemu sprzedaży
- Osoba po stronie firmy znająca mapowanie: OrderID Stripe a numer dokumentu w ERP lub sklepie
- Dostęp do systemu sprzedaży (WooCommerce, ERP lub inny) do kojarzenia transakcji z dokumentami
Gdzie to działa najlepiej
kierownik księgowości
Rano przed pracą otwiera raport: 47 transakcji dopasowanych automatycznie, 3 wymagają potwierdzenia, w tym dwa zamówienia o identycznej kwocie złożone przez tego samego klienta w ciągu minuty.
Z asystentem: Asystent przygotował adnotację przy każdej rozbieżności. Kierownik zatwierdza listę w kilka minut zamiast przeszukiwać ręcznie dwa systemy przez pół godziny.
specjalista obsługi klienta
Klient inicjuje chargeback przez bank. Asystent wykrywa zdarzenie charge.dispute.created i natychmiast wysyła powiadomienie na Slack z identyfikatorem transakcji, datą wysyłki i numerem przesyłki kurierskiej.
Z asystentem: Specjalista dostaje gotowe dane do odpowiedzi na spór w ciągu minut od jego otwarcia, nie po kilku dniach, gdy okno odpowiedzi zdążyło się już zwęzić.
dyrektor finansowy
Na koniec miesiąca pyta, ile realnie wpłynęło po prowizjach Stripe, z podziałem na walutę i typ transakcji. Wcześniej ktoś z księgowości liczył to raz w miesiącu ręcznie z eksportu do Excela.
Z asystentem: Asystent generuje zestawienie na bieżąco, sumując pole fee z obiektów BalanceTransaction. Dyrektor widzi koszt bramki dla każdej waluty bez czekania na koniec okresu.
Jak to uruchamiamy
- Rozmowa 15 minut. Mówicie, na czym pracujecie i co Was korkuje. Mówimy, czy da się to spiąć.
- Podłączenie i pierwsze pytania. Zaczynamy od odczytu, na Waszym serwerze, w zakresie który zatwierdzacie.
- Rozszerzanie. Dokładamy kolejne moduły i akcje, gdy zespół już ufa temu, co dostaje.
Koszt: od 3 000 zł miesięcznie. W tym wdrożenie, integracja, szkolenie zespołu i opieka. Widełki na Wasz przypadek podajemy na tej pierwszej rozmowie, bez ofert na dwadzieścia stron.
Chcecie najpierw poczytać konkrety: jakie moduły ruszamy, jakie dane bierzemy i czego potrzebujemy po Waszej stronie?
Cały opis integracji z Stripe →Czego asystent nie robi
Żebyście wiedzieli, gdzie kończy się jego rola, zanim zaczniecie.
- Nie księguje transakcji samodzielnie: wpisy w systemie księgowym wymagają zatwierdzenia przez uprawnioną osobę.
- Nie zmienia danych w Stripe (kwot, statusów, zwrotów) bez jawnego potwierdzenia.
- Nie wysyła odpowiedzi na spór do Stripe samodzielnie: szkic przygotowuje, decyzję podejmuje człowiek.
- Nie zastępuje oceny przy transakcjach z rozbieżnością: flaguje je z adnotacją i czeka na decyzję.
Pytania o integrację z Stripe
Czy asystent ma dostęp do numerów kart płatniczych naszych klientów?
Nie. Stripe nigdy nie ujawnia przez API numerów kart: te dane zostają w zaszyfrowanych systemach PCI-DSS Stripe. Asystent widzi wyłącznie metadane transakcji: identyfikator, kwotę, walutę, status i pola z obiektu Charge. Danych wrażliwych płatników w API Stripe po prostu nie ma.
Czy możemy przeanalizować historię transakcji sprzed daty wdrożenia?
Tak, Stripe API pozwala pobierać historyczne obiekty bez ograniczeń dat. Po podłączeniu asystent może przejrzeć dowolny wsteczny okres, na przykład cały poprzedni rok, i pokazać zestawienie prowizji, sporów i zwrotów. Zakres historyczny ustalamy przy wdrożeniu.
Co jeśli firma ma kilka kont Stripe dla różnych krajów albo marek?
Asystent może działać z kilkoma kontami Stripe jednocześnie. Każde konto podłącza się osobnym Restricted Key. Raporty można budować osobno dla każdego konta albo łącznie, gdy firma chce zobaczyć konsolidację. Konfigurację ustala się przy wdrożeniu.
Ile czasu zajmuje podłączenie i kiedy asystent zaczyna działać?
Samo połączenie przez API, jeśli firma ma już poprawnie wypełnione pole metadata przy transakcjach, trwa kilka godzin. Największe ryzyko to brak mapowania OrderID na numer dokumentu w ERP lub sklepie. Ustalenie tego mapowania z osobą po stronie firmy zajmuje zwykle jeden dzień roboczy.
Piętnaście minut o Stripe
Wybierzcie termin z kalendarza. Na rozmowie powiemy wprost, co da się u Was podłączyć, ile to trwa i ile kosztuje. Jeśli nie ma czego automatyzować, też to powiemy. A jeśli ma, dostajecie 14 dni działającej platformy podłączonej pod Stripe, żeby sprawdzić to na własnych danych zamiast wierzyć nam na słowo.
Sklepy i sprzedaż online
Stripe jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.