{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/en/simpay-flow/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Onboarding via SimPay Panel","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-via-simpay-panel","__idx":0},"children":["Onboarding via SimPay Panel"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This onboarding method applies to Flow services with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["role_non_financial_provider"]}," role - marketplace platforms and products that do not intermediate in the transfer of funds."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The submerchant goes through full onboarding in the SimPay Panel:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["verification of billing data (company or unregistered business data),"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ultimate beneficial owner (UBO) data,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["identity verification - document scan or mObywatel authorization,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["verification transfer."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You don't process any of this data - the entire process takes place at SimPay."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-does-it-work","__idx":1},"children":["How does it work?"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You register the submerchant (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/flow/flowcreatesubmerchant"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /flow/{flowServiceId}/submerchants"]}]},") and receive ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onboarding.action"]}," = ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirect_user"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onboarding.redirectUrl"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You redirect the submerchant to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The submerchant fills in the data and goes through verification in the SimPay Panel."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Once the data is submitted, the submerchant status changes to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_submerchant_in_verification"]},", and after SimPay approval - to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_submerchant_active"]},". We notify you about each change with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_submerchant:status_changed"]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/simpay-flow/webhooks"},"children":["webhook"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"link-validity","__idx":2},"children":["Link validity"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"The link is valid for 15 minutes"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]}," is valid for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["15 minutes"]}," after it is generated. Don't send it by email or store it - generate it at the moment you redirect the user."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the link has expired or the submerchant interrupted onboarding, generate a new one with the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/flow/flowsubmerchantonboarding"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /flow/{flowServiceId}/submerchants/{submerchantId}/onboardings"]}]}," request:"]},{"$$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 YOUR_API_TOKEN\" \\\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":["Submerchant onboarding is valid for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["60 days"]}," after registration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a submerchant that is already active, the endpoint returns the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUBMERCHANT_ALREADY_ACTIVE"]}," error."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"recommended-flow-in-your-application","__idx":3},"children":["Recommended flow in your application"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The user in your application clicks e.g. \"Enable online payments\"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If they are not a submerchant yet - you register them and immediately redirect them to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If they are already registered but not active - you generate a new link (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST .../onboardings"]},") and redirect them."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Until you receive a webhook with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_submerchant_active"]}," status, you show the user that verification is in progress."]}]}]},"headings":[{"value":"Onboarding via SimPay Panel","id":"onboarding-via-simpay-panel","depth":1},{"value":"How does it work?","id":"how-does-it-work","depth":2},{"value":"Link validity","id":"link-validity","depth":2},{"value":"Recommended flow in your application","id":"recommended-flow-in-your-application","depth":2}],"frontmatter":{"seo":{"title":"Onboarding via SimPay Panel"}},"lastModified":"2026-10-01T15:18:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en/simpay-flow/onboarding/redirect","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}