# Onboarding przez API

Ten sposób onboardingu dotyczy usług Flow z rolą `role_payment_service_provider` - regulowanych instytucji płatniczych (IP).

Jako instytucja płatnicza odpowiadasz za weryfikację swoich submerchantów, dlatego onboarding w SimPay jest uproszczony. Przekazujesz przez API:

- podstawowe dane rozliczeniowe submerchanta (dane firmy lub działalności nierejestrowanej),
- uproszczone dane beneficjentów rzeczywistych (UBO),
- dane usługi Płatności Online submerchanta - przekazywane już przy rejestracji w obiekcie `service`.


Środki z transakcji submerchantów nie są wypłacane bezpośrednio submerchantom, lecz do instytucji płatniczej. Rozliczenie z submerchantami leży po stronie IP.

## Jak to działa?

1. Rejestrujesz submerchanta ([`POST /flow/{flowServiceId}/submerchants`](/apis/flow/flowcreatesubmerchant)), przekazując obowiązkowo obiekt `service`. W odpowiedzi otrzymujesz `onboarding.action` = `provide_api`.
2. Przekazujesz przez API dane rozliczeniowe i dane UBO submerchanta, a następnie finalizujesz onboarding.
3. Po weryfikacji przez SimPay status submerchanta zmienia się na `flow_submerchant_active` - informację otrzymasz [webhookiem](/simpay-flow/webhooks) `flow_submerchant:status_changed`.


Dokumentacja w przygotowaniu
Szczegółowa specyfikacja endpointów onboardingu przez API pojawi się wkrótce. Jeśli jesteś instytucją płatniczą i chcesz rozpocząć integrację, skontaktuj się z SimPay.