Przejdź do treści
Ostatnia aktualizacja

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.


Jak to działa?

  1. Rejestrujesz submerchanta (POST /flow/{flowServiceId}/submerchants) i otrzymujesz onboarding.action = redirect_user oraz onboarding.redirectUrl.
  2. Przekierowujesz submerchanta na redirectUrl.
  3. Submerchant uzupełnia dane i przechodzi weryfikację w Panelu SimPay.
  4. Po przekazaniu danych status submerchanta zmienia się na flow_submerchant_in_verification, a po akceptacji przez SimPay - na flow_submerchant_active. O każdej zmianie informujemy webhookiem flow_submerchant:status_changed.

Ważność linku

Link jest ważny 15 minut

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.


Zalecany przebieg w Twojej aplikacji

  1. Użytkownik w Twojej aplikacji klika np. „Włącz płatności online”.
  2. Jeśli nie jest jeszcze submerchantem - rejestrujesz go i od razu przekierowujesz na redirectUrl.
  3. Jeśli jest już zarejestrowany, ale nie jest aktywny - generujesz nowy link (POST .../onboardings) i przekierowujesz.
  4. Do czasu otrzymania webhooka ze statusem flow_submerchant_active pokazujesz użytkownikowi informację, że weryfikacja jest w toku.