CashBill — jak płacić: integracje i zwroty

CashBill API pozwala wdrożyć płatności bezpośrednio w serwisie, również w modelu white-label, pod marką sklepu.¹ Jak wygląda płatność po stronie klienta? Poradnik omawia też integrację, obsługę transakcji, zwroty i typowe błędy z perspektywy małej firmy.

Czym jest CashBill API i kiedy mały sklep go potrzebuje?

CashBill API łączy sklep internetowy z systemem płatności, gdy firma wybiera własne wdrożenie zamiast gotowej wtyczki. Deweloperzy mają do dyspozycji materiały CashBill dotyczące REST, SOAP i przykłady integracji.²
REST i SOAP służą do wymiany danych między systemami. Dokumentacja REST CashBill opisuje 3 operacje dotyczące transakcji: jej utworzenie, pobranie szczegółów i ustawienie adresu strony powrotu³.

CashBill przewiduje gotowe rozwiązania i połączenia dostosowane do platformy sklepu.⁴ Operator deklaruje też możliwość przygotowania rozwiązania wspierającego księgowość oraz automatyczną wymianę danych.⁴ Na liście CashBill widnieje 35 gotowych integracji z platformami i narzędziami sprzedaży⁴.

Jak przygotować dane dostępowe do połączenia sklepu z CashBill?

Przed konfiguracją sklep wybiera sposób integracji i przygotowuje dostęp do konta CashBill. Według CashFix rejestracja w CashBill zajmuje około 5 minut.⁵
Sklep korzystający z wtyczki konfiguruje ją dla swojej platformy. Przy własnym wdrożeniu osoba odpowiedzialna za połączenie potrzebuje odpowiedniej dokumentacji.

CashBill udostępnia osobne API do obsługi kodów dostępowych usługi SMS Kod Automatyczny.¹ Dokumentacja ma wersję 2.0.0 i rozmiar 185,35 kB. Opisuje kody SMS, nie konfigurację płatności w sklepie.¹

Skąd sklep wie, że zmienił się status płatności?

Po integracji sprzedawca może śledzić opłacone transakcje w panelu CashBill.⁴ Zanim oznaczy zamówienie jako opłacone, powinien porównać jego status ze stanem transakcji w panelu.
Sam powrót klienta na stronę sklepu nie potwierdza zapłaty.

Czy CashBill można podłączyć do WooCommerce, PrestaShop i Shopify?

CashBill oferuje gotową integrację albo indywidualne połączenie z platformą e-commerce. CashFix wskazuje wtyczki oraz API do własnych rozwiązań.⁵ W sklepach opartych na WooCommerce, PrestaShop lub Shopify wybór zależy od sposobu podłączenia i zakresu prac po stronie firmy².

Sklep może zacząć od gotowego modułu albo zaplanować własne połączenie. Punktem odniesienia jest lista 35 gotowych integracji opublikowana przez CashBill⁴. Tabela porównuje oba sposoby wdrożenia i zadania sklepu.

Gotowa wtyczka ogranicza własne prace integracyjne. Trzeba jednak dobrać moduł do używanej platformy. Własne połączenie przez CashBill API daje miejsce na indywidualną integrację, ale wymaga zorganizowania wdrożenia².

Czym jest CashBill jako operator płatności i jak sprawdzić błąd API?

CashBill obsługuje płatność klienta, a sklep łączy się z systemem operatora przez API lub integrację platformy. Gdy pojawi się błąd, sklep najpierw ustala, czy system przyjął żądanie API. Dopiero potem sprawdza status transakcji.
Przy tworzeniu transakcji odpowiedź HTTP 200 potwierdza poprawną obsługę żądania, nie zapłatę³.

Według CashFix CashBill nie udostępnia osobnego środowiska sandbox, czyli odizolowanego systemu do prób. Po rejestracji konta sklep może wypróbować Punkt Płatności w trybie testowym.⁵ Taka próba pozwala prześledzić zamówienie przed uruchomieniem płatności dla klientów.

Jak ustalić, czy problem dotyczy żądania API, czy statusu płatności?

Przy diagnozowaniu problemu sklep musi oddzielić działanie połączenia od wyniku płatności klienta. Kody HTTP 4xx oznaczają błąd żądania, a 5xx błąd serwera. Żaden z nich nie określa statusu płatności⁶.

• Żądanie API dotyczy wymiany danych między sklepem a operatorem. W razie problemu sklep odczytuje odpowiedź na żądanie i zapis błędu połączenia.
• Status transakcji dotyczy płatności za konkretne zamówienie. Sklep porównuje identyfikator zamówienia z transakcją widoczną w panelu.
• Tryb testowy Punktu Płatności pozwala przejść przez próbne zamówienie. Sklep zestawia jego przebieg z zamówieniem, przy którym wystąpił problem.

Osobna kontrola połączenia i płatności pomaga ustalić, co poszło nie tak.
Błędu połączenia nie należy utożsamiać z odmową płatności przez klienta. Status „PositiveFinish” oznacza potwierdzenie przekazania środków przez kanał płatności i jest statusem końcowym⁷.

Co dla płacącego oznacza status Krajowej Instytucji Płatniczej CashBill?

CashBill jako Krajowa Instytucja Płatnicza działa pod nadzorem Komisji Nadzoru Finansowego. Status operatora nie potwierdza jednak zapłaty za konkretny zakup. Płacący powinien odróżnić dane operatora od statusu zamówienia, a w sprawie zwrotu zakupu kontaktować się ze sklepem.
Numer wpisu CashBill S.A. jako krajowej instytucji płatniczej to IP10/2013⁴.

Płatność przez CashBill: metody, bezpieczeństwo i koszty

CashBill obsługuje różne metody płatności internetowej, ale klient wybiera spośród tych udostępnionych przy zamówieniu. Prowizja od transakcji obciąża sklep; nie jest automatycznie doliczana klientowi do ceny zakupów. Według CashFix standardowa prowizja CashBill od transakcji online wynosi 1,5%.⁵

Według CashFix CashBill pobiera 0 zł za wypłatę i 0 zł za zwrot środków. Typowy czas realizacji zleconej wypłaty to 1 dzień roboczy.⁵ Opłata operatora za zwrot środków nie przesądza o zasadach przyjęcia zwrotu towaru.

Jakie metody płatności może zobaczyć klient sklepu?

Na ekranie płatności klient może zobaczyć przelew, BLIK, kartę, portfel mobilny, płatność odroczoną lub Paysafecard. Zależy to od metod udostępnionych przez sklep. Pay-By-Link to przelew inicjowany z ekranu płatności. Poniższe stawki dotyczą sklepu zarejestrowanego przez link CashFix, nie opłaty doliczanej klientowi. Przy takiej rejestracji prowizja za płatność BLIK wynosi 1,2% wartości transakcji⁵.

Warunki rejestracji przez link CashFix obejmują prowizję za przelew natychmiastowy w wysokości 1,2% wartości transakcji⁵. Stawki dotyczą rozliczeń sklepu. Tabela porównuje prowizje CashBill za transakcję przy tej rejestracji.

Dane w tabeli: 5

Myślnik oznacza, że podane warunki nie określają dodatkowej opłaty za daną metodę. Klient bierze pod uwagę sposób autoryzacji i termin zapłaty. Sklep z kolei uwzględnia prowizję właściwą dla wybranej metody w swoich kosztach.

Co sprawdzić przed zatwierdzeniem płatności przez CashBill?

Klient płacący przez CashBill powinien porównać kwotę i nazwę sklepu na ekranie autoryzacji z zamówieniem. Przy płatności kartą lub przelewem powinien korzystać z połączenia HTTPS. Rozpozna je po adresie zaczynającym się od „https://”.
Po zatwierdzeniu płatności warto zachować potwierdzenie, jeśli status zamówienia w sklepie się nie zmieni.

Kiedy szybka płatność jest wygodna, a kiedy wymaga dodatkowej uwagi?

Płatność przez CashBill pozwala zapłacić BLIKIEM lub przelewem podczas składania zamówienia. Klient powinien zachować ostrożność, gdy ekran autoryzacji pokazuje inną kwotę. Podobnie jest wtedy, gdy wrócił do sklepu bez potwierdzenia transakcji.
Przed ponowieniem zapłaty trzeba ustalić status pierwszej próby.

Czy klient może wybrać płatność odroczoną przez CashBill?

CashBill uwzględnia PayPo, BLIK Płacę Później i Twisto w warunkach dla sprzedawców. Klient może wybrać płatność odroczoną, jeśli sklep udostępni ją przy zamówieniu. W odróżnieniu od płatności natychmiastowej należność reguluje później, na warunkach wybranej usługi.
Przed wyborem powinien przeczytać warunki spłaty przedstawione na ekranie płatności.

CashBill daje klientowi wybór spośród metod dostępnych w sklepie. Sprzedawca uwzględnia koszt rozliczenia przypisany do wybranej metody. To koszt sklepu, nie automatyczny dodatek do ceny zakupów.

Najczęściej zadawane pytania

Czy API CashBill do kodów SMS służy do obsługi płatności w sklepie?

Nie. Osobne API dotyczy usługi SMS Kod Automatyczny, a jego dokumentacja opisuje kody SMS, nie konfigurację płatności sklepowych.

Jakie operacje dotyczące transakcji opisuje dokumentacja REST CashBill?

Opisuje utworzenie transakcji, pobranie jej szczegółów i ustawienie adresu strony powrotu.

Czy CashBill może wspierać automatyczną wymianę danych z księgowością?

CashBill deklaruje możliwość przygotowania rozwiązania wspierającego księgowość i automatyczną wymianę danych.

Czy płatności CashBill można wdrożyć pod marką sklepu?

Tak. CashBill umożliwia wdrożenie płatności bezpośrednio w serwisie, także w modelu white-label pod marką sklepu.

Ceny i warunki sprawdzone u źródeł: październik 2026.