Skip to main content

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 https://panel.dpay.pl/api/partner/v1/onboarding
Authorization: Bearer dpk_twoj_klucz_platformy
Content-Type: application/json

{
  "first_name": "Jan",
  "last_name": "Kowalski",
  "email": "jan.kowalski@example.com",
  "phone": "601234567",
  "partner_external_ref": "faktura-klient-123",
  "consents": [1, 2, 3]
}

Odpowiedź:

{
  "id": 12345,
  "ref": "faktura-klient-123",
  "status": "started",
  "channel": "fakturka"
}

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.

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.