{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Wprowadzenie do DirectBilling (DCB)","description":"Znajdziesz tutaj wszystkie niezbędne informacje dotyczące integracji i obsługi systemu płatności SimPay.pl","siteUrl":"https://docs.simpay.pl","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"wprowadzenie-do-directbilling-dcb","__idx":0},"children":["Wprowadzenie do DirectBilling (DCB)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DirectBilling (znany również jako Direct Carrier Billing lub Zamów z Orange/Play/Plus/T-Mobile) to nowoczesna metoda płatności, w której koszt zakupu doliczany jest bezpośrednio do rachunku telefonicznego klienta (lub pobierany z konta pre-paid)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dzięki temu proces płatności jest niezwykle szybki i wygodny – klient nie musi logować się do banku ani podawać danych karty płatniczej. Wystarczy mu jedynie telefon komórkowy pod ręką. Metoda ta idealnie sprawdza się w przypadku mikropłatności, dostępu do treści cyfrowych, gier czy usług VOD."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"obsługiwani-operatorzy","__idx":1},"children":["Obsługiwani operatorzy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SimPay obsługuje największych operatorów telekomunikacji w Polsce, co gwarantuje najwyższą dostępność usług i najlepsze stawki prowizyjne. Obsługujemy płatności w sieciach:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Orange"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Play"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Plus"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["T-Mobile"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Netia"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cykl-życia-transakcji-statusy","__idx":2},"children":["Cykl życia transakcji (Statusy)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transakcje DirectBilling charakteryzują się specyficznym cyklem życia. Ponieważ weryfikacja następuje u operatora GSM, status płatności może zmieniać się dynamicznie."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Poniżej znajduje się pełna lista wartości, jakie może przyjąć pole ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," w powiadomieniach IPN oraz odpowiedziach z API:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_db_new"]}]}," – Transakcja została poprawnie wygenerowana w systemie SimPay. Klient rozpoczął proces płatności."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_db_confirmed"]}]}," – Transakcja została potwierdzona przez operatora GSM (np. klient prawidłowo przepisał kod PIN ze swojego telefonu). System oczekuje na ostateczne potwierdzenie pobrania środków."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_db_payed"]}]}," – ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sukces!"]}," Środki zostały pomyślnie pobrane z konta klienta lub doliczone do jego abonamentu."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_db_rejected"]}]}," – Transakcja została ostatecznie odrzucona przez operatora. Najczęstsze powody to: brak wystarczających środków na koncie pre-paid, założona blokada na usługi Premium/DCB u operatora, lub przekroczenie miesięcznego limitu na tego typu usługi."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_db_canceled"]}]}," – Transakcja została anulowana. Może to nastąpić, gdy klient sam zrezygnuje z płatności (np. kliknie \"Anuluj\") lub gdy minie maksymalny czas na wpisanie kodu PIN (timeout)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_db_generate_error"]}]}," – Wystąpił niespodziewany błąd techniczny podczas próby nawiązania połączenia i wygenerowania żądania bezpośrednio po stronie operatora GSM."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Wskazówka"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pamiętaj, aby wydawać klientowi produkt lub dostęp do usługi cyfrowej ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["wyłącznie"]}," wtedy, gdy otrzymasz powiadomienie IPN ze statusem ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_db_payed"]}]},". Status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_db_confirmed"]}," oznacza jedynie udaną autoryzację, ale nie gwarantuje jeszcze pobrania środków."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"co-dalej","__idx":3},"children":["Co dalej?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Teraz, gdy wiesz już, czym jest DirectBilling i jakie statusy mogą przyjmować transakcje, przejdź do kolejnych sekcji, aby zaimplementować tę metodę w swoim systemie:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["👉 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/directbilling/transaction"},"children":["Generowanie transakcji"]}]}," – dowiedz się, jak wysłać żądanie inicjujące płatność."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["👉 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/notifications/directbilling"},"children":["Powiadomienia IPN"]}]}," – sprawdź, jak zintegrować odbieranie webhooków o zmianie statusu transakcji DirectBilling."]}]},"headings":[{"value":"Wprowadzenie do DirectBilling (DCB)","id":"wprowadzenie-do-directbilling-dcb","depth":1},{"value":"Obsługiwani operatorzy","id":"obsługiwani-operatorzy","depth":2},{"value":"Cykl życia transakcji (Statusy)","id":"cykl-życia-transakcji-statusy","depth":2},{"value":"Co dalej?","id":"co-dalej","depth":2}],"frontmatter":{"seo":{"title":"Wprowadzenie do DirectBilling (DCB)"}},"lastModified":"2026-05-12T14:19:02.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/directbilling","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}