# Onboarding przez Panel SimPay

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`](/apis/flow/flowcreatesubmerchant)) 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](/simpay-flow/webhooks) `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`](/apis/flow/flowsubmerchantonboarding):


```bash
curl -X POST "https://api.simpay.pl/flow/{flowServiceId}/submerchants/user-123/onboardings" \
  -H "Authorization: Bearer TWÓJ_TOKEN_API" \
  -H "Accept: application/json"
```


```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.