Ten sposób onboardingu dotyczy usług Flow z rolą role_non_financial_provider - platform marketplace i produktów, które nie pośredniczą w przekazywaniu środków.
Submerchant przechodzi pełny onboarding w Panelu SimPay:
- weryfikację danych rozliczeniowych (dane firmy lub działalności nierejestrowanej),
- dane beneficjentów rzeczywistych (UBO),
- weryfikację tożsamości - skan dokumentu lub autoryzację przez mObywatela,
- przelew weryfikacyjny.
Ty nie przetwarzasz żadnych z tych danych - cały proces odbywa się po stronie SimPay.
- Rejestrujesz submerchanta (
POST /flow/{flowServiceId}/submerchants) i otrzymujeszonboarding.action=redirect_userorazonboarding.redirectUrl. - Przekierowujesz submerchanta na
redirectUrl. - Submerchant uzupełnia dane i przechodzi weryfikację w Panelu SimPay.
- Po przekazaniu danych status submerchanta zmienia się na
flow_submerchant_in_verification, a po akceptacji przez SimPay - naflow_submerchant_active. O każdej zmianie informujemy webhookiemflow_submerchant:status_changed.
redirectUrl jest linkiem ważnym przez 15 minut od wygenerowania. Nie wysyłaj go mailem i nie zapisuj - generuj go w momencie, w którym przekierowujesz użytkownika.
Jeśli link wygasł lub submerchant przerwał onboarding, wygeneruj nowy żądaniem POST /flow/{flowServiceId}/submerchants/{submerchantId}/onboardings:
curl -X POST "https://api.simpay.pl/flow/{flowServiceId}/submerchants/user-123/onboardings" \
-H "Authorization: Bearer TWÓJ_TOKEN_API" \
-H "Accept: application/json"{
"success": true,
"data": {
"action": "redirect_user",
"redirectUrl": "https://panel.simpay.pl/..."
}
}Onboarding submerchanta jest ważny przez 60 dni od jego rejestracji.
Dla submerchanta, który jest już aktywny, endpoint zwróci błąd SUBMERCHANT_ALREADY_ACTIVE.
- Użytkownik w Twojej aplikacji klika np. „Włącz płatności online”.
- Jeśli nie jest jeszcze submerchantem - rejestrujesz go i od razu przekierowujesz na
redirectUrl. - Jeśli jest już zarejestrowany, ale nie jest aktywny - generujesz nowy link (
POST .../onboardings) i przekierowujesz. - Do czasu otrzymania webhooka ze statusem
flow_submerchant_activepokazujesz użytkownikowi informację, że weryfikacja jest w toku.