{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-simpay-flow/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Czym jest SimPay Flow?","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":"czym-jest-simpay-flow","__idx":0},"children":["Czym jest SimPay Flow?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SimPay Flow pozwala Ci przyjmować płatności ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["w imieniu Twoich Klientów"]}," (submerchantów) w ramach jednego konta SimPay i jednej integracji API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SimPay Flow jest przeznaczony dla:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["platform marketplace"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["produktów, w których Twoi Klienci przyjmują płatności"]}," - systemy zbiórek, systemy fakturowe, aplikacje ERP, systemy rezerwacji itp.,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["regulowanych instytucji płatniczych"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"podstawowe-pojęcia","__idx":1},"children":["Podstawowe pojęcia"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Pojęcie"},"children":["Pojęcie"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Opis"},"children":["Opis"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Usługa Flow"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Twoja usługa w SimPay Flow (ID w formacie ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_xxxxxxxx"]},"). Zakładasz ją w Panelu Partnera SimPay, a przed użyciem musi zostać zaakceptowana przez SimPay."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Usługa nadrzędna"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Usługa Płatności Online powiązana z usługą Flow. To jej ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["serviceId"]}," podajesz w żądaniach ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/payment/{serviceId}/..."]},", gdy tworzysz transakcje dla submerchantów."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Submerchant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Twój Klient, zarejestrowany przez Ciebie w usłudze Flow. Ma własne ID (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flsm_xxxxxxxx"]},") oraz nadany przez Ciebie ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customId"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Usługa submerchanta"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Usługa Płatności Online submerchanta, tworzona automatycznie przy rejestracji. Nie używasz jej bezpośrednio - transakcje tworzysz zawsze przez usługę nadrzędną."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Portfel submerchanta"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Saldo submerchanta, na które trafiają środki z jego transakcji i z którego realizowane są wypłaty."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"role-usługi-flow","__idx":2},"children":["Role usługi Flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Każda usługa Flow ma jedną z dwóch ról. Rola decyduje o tym, jak wygląda onboarding submerchantów i rozliczenie."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"platformy--role_non_financial_provider-","__idx":3},"children":["Platformy (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["role_non_financial_provider"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dla marketplace'ów i produktów, które ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["nie pośredniczą w przekazywaniu środków"]},"."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submerchant przechodzi pełny onboarding w SimPay - weryfikację danych rozliczeniowych, danych UBO, dokumentu tożsamości (lub mObywatela) oraz przelew weryfikacyjny. Szczegóły: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/simpay-flow/onboarding/redirect"},"children":["Onboarding przez Panel SimPay"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Rozliczenie z submerchantem prowadzi SimPay - środki trafiają na portfel submerchanta i są wypłacane na jego rachunek."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ty otrzymujesz ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/simpay-flow/commissions"},"children":["prowizję"]}," od transakcji submerchantów."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Poza onboardingiem całą obsługę submerchanta - kanały płatności, wypłaty, raporty - realizujesz przez ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/flow"},"children":["API SimPay Flow"]}," w swojej aplikacji."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"instytucje-płatnicze--role_payment_service_provider-","__idx":4},"children":["Instytucje płatnicze (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["role_payment_service_provider"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dla ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["regulowanych instytucji płatniczych (IP)"]},", które same odpowiadają za swoich submerchantów."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Onboarding jest uproszczony - przekazujesz przez API podstawowe dane firmy (lub działalności nierejestrowanej), uproszczone dane UBO oraz dane usługi Płatności Online submerchanta. Szczegóły: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/simpay-flow/onboarding/api"},"children":["Onboarding przez API"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Całość środków jest przekazywana do IP, a rozliczenie z submerchantami leży po stronie IP."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SimPay Flow służy IP głównie do zgłaszania submerchantów do dodatkowych metod płatności, np.:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["PayPo,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Twisto,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["PaysafeCard,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["BLIK Level 0 + OneClick,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["BLIK Płatności Powtarzalne,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["LATAM."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["IP zgłasza przez API rejestrację kanału płatności dla submerchanta, a SimPay w imieniu IP zgłasza go u operatora metody płatności."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"jak-wygląda-integracja","__idx":5},"children":["Jak wygląda integracja?"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Załóż usługę Flow"]}," w Panelu Partnera SimPay i poczekaj na jej akceptację (status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_service_active"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Wygeneruj klucz API"]}," z uprawnieniami do SimPay Flow (patrz ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#uprawnienia-klucza-api"},"children":["Uprawnienia klucza API"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Zarejestruj submerchanta"]}," przez API - ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/simpay-flow/onboarding"},"children":["Rejestracja submerchantów"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Przeprowadź onboarding"]}," submerchanta i poczekaj, aż jego status zmieni się na ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_submerchant_active"]}," - informację otrzymasz ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/simpay-flow/webhooks"},"children":["webhookiem"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Skonfiguruj kanały płatności"]}," submerchanta - ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/simpay-flow/channels"},"children":["Kanały płatności"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Przyjmuj płatności"]}," w imieniu submerchanta - ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/simpay-flow/payments"},"children":["Płatności"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Obsłuż finanse"]}," - saldo, wypłaty, raporty i faktury - ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/simpay-flow/finances"},"children":["Finanse i wypłaty"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"uprawnienia-klucza-api","__idx":6},"children":["Uprawnienia klucza API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Endpointy SimPay Flow wymagają klucza API z odpowiednimi uprawnieniami. Nadaj kluczowi tylko te uprawnienia, których faktycznie potrzebujesz."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Uprawnienie"},"children":["Uprawnienie"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Zakres"},"children":["Zakres"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.services"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Podgląd usług Flow"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.submerchants"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Podgląd submerchantów"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.submerchants.create"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rejestracja submerchantów"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.submerchants.onboardings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Onboarding submerchantów"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.submerchants.widget"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Generowanie linków do widgetu submerchanta"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.payment_methods"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Podgląd i włączanie/wyłączanie kanałów płatności"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.payment_methods.register"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rejestracja nowych kanałów płatności"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.submerchants.webhooks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Podgląd ustawień webhooków submerchanta"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.submerchants.webhooks.update"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Zmiana ustawień i kluczy webhooków submerchanta"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.submerchants.finances"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Podgląd portfeli i operacji"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.submerchants.finances.reports"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Generowanie raportów CSV"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.submerchants.finances.invoices"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Podgląd faktur prowizyjnych"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.submerchants.withdraws"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Podgląd wypłat"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.submerchants.withdraws.create"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Zlecanie wypłat"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow.submerchants.withdraws.settings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Zmiana ustawień wypłat portfela"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do tworzenia transakcji w imieniu submerchantów potrzebujesz dodatkowo standardowych uprawnień Płatności Online (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.*"]},")."]}]},"headings":[{"value":"Czym jest SimPay Flow?","id":"czym-jest-simpay-flow","depth":1},{"value":"Podstawowe pojęcia","id":"podstawowe-pojęcia","depth":2},{"value":"Role usługi Flow","id":"role-usługi-flow","depth":2},{"value":"Platformy ( role_non_financial_provider )","id":"platformy--role_non_financial_provider-","depth":3},{"value":"Instytucje płatnicze ( role_payment_service_provider )","id":"instytucje-płatnicze--role_payment_service_provider-","depth":3},{"value":"Jak wygląda integracja?","id":"jak-wygląda-integracja","depth":2},{"value":"Uprawnienia klucza API","id":"uprawnienia-klucza-api","depth":2}],"frontmatter":{"seo":{"title":"Czym jest SimPay Flow?"}},"lastModified":"2026-10-01T15:18:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/simpay-flow","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}