Przejdź do głównej zawartości

Onboarding przez redirect (hosted)

W tym trybie przekierowujesz merchanta do hostowanego onboardingu dpay (pełna strona), a o postępie i zakończeniu dowiadujesz się z webhooków. To najprostszy wariant, gdy nie chcesz osadzać iframe albo gdy przeglądarki merchantów blokują ciasteczka firm trzecich.

Przepływ​

Krok 1: utwórz onboarding i pobierz adres hostowanego flow​

Po swojej stronie serwera utwórz draft wywołaniem API (dane kontaktowe merchanta + zgody):

POST/api/partner/v1/onboardingUtwórz draft onboardingu (dane kontaktowe merchanta + zgody).Pełny kontrakt w API Reference

Adres hostowanego flow zwraca POST /onboarding/{ref}/finalize (albo GET /onboarding/{ref}) w polu next_action.url - szczegóły pól opisuje onboarding przez API.

POST/api/partner/v1/onboarding/{ref}/finalizePobierz adres hostowanego flow (next_action.url).Pełny kontrakt w API Reference GET/api/partner/v1/onboarding/{ref}Odczyt statusu (uzupełniająco do webhooków).Pełny kontrakt w API Reference

Krok 2: przekieruj merchanta​

Przekieruj przeglądarkę merchanta na next_action.url:

HTTP/1.1 302 Found
Location: https://panel.dpay.pl/onboarding-v3/continue/...

Merchant przechodzi cały onboarding na hostowanej stronie dpay (spójny, brandowany UI, wszystkie kroki KYC/AML i podpis umowy) i tam też kończy flow - dpay nie przekierowuje go z powrotem na Twój adres.

Krok 3: śledź postęp webhookami​

Źródłem prawdy o postępie są webhooki - dostajesz zdarzenie przy każdej zmianie statusu (agreement_signed, pending_transfer, completed, ...). Uzupełniająco możesz odpytać GET /onboarding/{ref}.

Nie ma parametru return_url

API nie przyjmuje adresu powrotnego - merchant kończy w hostowanym flow dpay. Jeśli potrzebujesz odzyskać merchanta w swoim produkcie po zakończeniu, osadź flow w iframe i reaguj na zdarzenia SDK (m.in. completed), albo po prostu poinstruuj merchanta, aby wrócił do Twojej aplikacji.

next_action.url - trwałość i wznawianie​

Link jest wznawialny. Jeśli merchant przerwie onboarding, możesz przekierować go pod ten sam adres, aby kontynuował od miejsca, w którym skończył (dpay pamięta postęp).

  • Ważność linku: 45 dni. Link przestaje też działać po aktywacji konta.
  • Po wygaśnięciu link zwraca 410 Gone. Powtórny POST /onboarding z tym samym ref zwraca istniejący draft bez wymiany tokenu - wygasłego linku nie odnowisz samodzielnie, skontaktuj się z dpay.
Wznawianie w SDK

Jeśli równolegle używasz SDK, możesz osadzić hostowane flow także metodą DpayOnboarding.mountResume(target, { token }) - token to ostatni segment ścieżki next_action.url. Szczegóły w onboardingu przez API.

Kiedy wybrać redirect​

  • Nie chcesz osadzać iframe ani zależeć od ciasteczek firm trzecich.
  • Wolisz najprostszą możliwą integrację (utworzenie draftu + przekierowanie).
  • Merchant i tak realizuje onboarding jako osobny, jednorazowy krok.

Jeśli chcesz, aby merchant nie opuszczał Twojej strony, użyj iframe. Jeśli chcesz zbudować własny UI onboardingu, zobacz API.