{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-simpay-flow/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Onboarding przez Panel SimPay","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":"onboarding-przez-panel-simpay","__idx":0},"children":["Onboarding przez Panel SimPay"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ten sposób onboardingu dotyczy usług Flow z rolą ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["role_non_financial_provider"]}," - platform marketplace i produktów, które nie pośredniczą w przekazywaniu środków."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Submerchant przechodzi pełny onboarding w Panelu SimPay:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["weryfikację danych rozliczeniowych (dane firmy lub działalności nierejestrowanej),"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dane beneficjentów rzeczywistych (UBO),"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["weryfikację tożsamości - skan dokumentu lub autoryzację przez mObywatela,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["przelew weryfikacyjny."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ty nie przetwarzasz żadnych z tych danych - cały proces odbywa się po stronie SimPay."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"jak-to-działa","__idx":1},"children":["Jak to działa?"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Rejestrujesz submerchanta (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/flow/flowcreatesubmerchant"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /flow/{flowServiceId}/submerchants"]}]},") i otrzymujesz ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onboarding.action"]}," = ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirect_user"]}," oraz ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onboarding.redirectUrl"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Przekierowujesz submerchanta na ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submerchant uzupełnia dane i przechodzi weryfikację w Panelu SimPay."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Po przekazaniu danych status submerchanta zmienia się na ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_submerchant_in_verification"]},", a po akceptacji przez SimPay - na ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_submerchant_active"]},". O każdej zmianie informujemy ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/simpay-flow/webhooks"},"children":["webhookiem"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_submerchant:status_changed"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ważność-linku","__idx":2},"children":["Ważność linku"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Link jest ważny 15 minut"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]}," jest linkiem ważnym przez ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["15 minut"]}," od wygenerowania. Nie wysyłaj go mailem i nie zapisuj - generuj go w momencie, w którym przekierowujesz użytkownika."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Jeśli link wygasł lub submerchant przerwał onboarding, wygeneruj nowy żądaniem ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/flow/flowsubmerchantonboarding"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /flow/{flowServiceId}/submerchants/{submerchantId}/onboardings"]}]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api.simpay.pl/flow/{flowServiceId}/submerchants/user-123/onboardings\" \\\n  -H \"Authorization: Bearer TWÓJ_TOKEN_API\" \\\n  -H \"Accept: application/json\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": true,\n  \"data\": {\n    \"action\": \"redirect_user\",\n    \"redirectUrl\": \"https://panel.simpay.pl/...\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Onboarding submerchanta jest ważny przez ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["60 dni"]}," od jego rejestracji."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dla submerchanta, który jest już aktywny, endpoint zwróci błąd ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUBMERCHANT_ALREADY_ACTIVE"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"zalecany-przebieg-w-twojej-aplikacji","__idx":3},"children":["Zalecany przebieg w Twojej aplikacji"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Użytkownik w Twojej aplikacji klika np. „Włącz płatności online”."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Jeśli nie jest jeszcze submerchantem - rejestrujesz go i od razu przekierowujesz na ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Jeśli jest już zarejestrowany, ale nie jest aktywny - generujesz nowy link (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST .../onboardings"]},") i przekierowujesz."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do czasu otrzymania webhooka ze statusem ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_submerchant_active"]}," pokazujesz użytkownikowi informację, że weryfikacja jest w toku."]}]}]},"headings":[{"value":"Onboarding przez Panel SimPay","id":"onboarding-przez-panel-simpay","depth":1},{"value":"Jak to działa?","id":"jak-to-działa","depth":2},{"value":"Ważność linku","id":"ważność-linku","depth":2},{"value":"Zalecany przebieg w Twojej aplikacji","id":"zalecany-przebieg-w-twojej-aplikacji","depth":2}],"frontmatter":{"seo":{"title":"Onboarding przez Panel SimPay"}},"lastModified":"2026-10-01T15:18:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/simpay-flow/onboarding/redirect","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}