dpay Connect
dpay Connect to platforma Payments-as-a-Service dla partnerów. Jeśli budujesz produkt, w którym Twoi klienci przyjmują płatności (system fakturowy, marketplace, platforma dla księgowych, system zbiórek), dpay Connect pozwala Ci osadzić onboarding merchanta i obsługiwać jego konto bezpośrednio z Twojej aplikacji.
Twój klient (merchant) nie musi wychodzić do osobnego panelu dpay. Rejestrację, płatności i wypłaty realizuje w Twoim produkcie, a Ty sterujesz kontem przez proste API.
Nazywamy Cię partnerem lub ISV (Independent Software Vendor). Przykłady: system do wystawiania faktur z linkiem do zapłaty, operator marketplace, platforma do zbiórek, oprogramowanie księgowe.
Jak to działa w skrócie
- Merchant rejestruje się w Twoim produkcie i przechodzi onboarding dpay (osadzony u Ciebie).
- Po podpisaniu umowy przez merchanta rejestrujesz płatności, a po jego opt-in zlecasz wypłaty w imieniu merchanta (on-behalf), jednym kluczem partnera.
- dpay informuje Cię webhookami o każdym zdarzeniu (zmiana statusu, płatność, wypłata).
- Środki ze sprzedaży trafiają na zweryfikowany rachunek merchanta. Nigdy nie przechodzą przez Ciebie.
Model: merchant jest właścicielem środków
dpay Connect działa w modelu delegowanym (podobnym do Stripe Connect Standard). To ważne, bo decyduje o Twoich obowiązkach:
- Merchant jest merchant-of-record - to on sprzedaje końcowemu klientowi, on przechodzi weryfikację (KYC/AML), on jest odbiorcą rozliczeń.
- Środki nigdy nie przechodzą przez Ciebie. Ty inicjujesz akcje (zarejestruj płatność, zleć wypłatę), ale pieniądze idą bezpośrednio na rachunek merchanta.
- Wypłata zawsze trafia na zweryfikowany rachunek merchanta. Nie podajesz numeru rachunku ani kwoty - dpay używa rachunku z akt merchanta i wypłaca całe dostępne saldo. Ty decydujesz tylko kiedy.
Dzięki temu nie stajesz się instytucją płatniczą i nie potrzebujesz licencji na przechowywanie środków klienta.
Konto captive: jedno konto na jednego partnera
Konto merchanta założone przez Twój kanał należy do Ciebie i jest przez Ciebie zarządzane. Ta sama firma współpracująca z dwoma różnymi partnerami ma dwa osobne konta dpay, każde z własnym saldem, rozliczeniem i umową.
Trzy sposoby onboardingu merchanta
Wybierz sposób pasujący do Twojego produktu. Wszystkie prowadzą do tego samego efektu: aktywne konto merchanta powiązane z Twoim kanałem.
| Sposób | Kiedy używać | Nakład pracy |
|---|---|---|
| Iframe (widżet) | Chcesz gotowy, spójny UI dpay osadzony u siebie | Najmniejszy |
| Redirect (hosted) | Wolisz przekierować merchanta do hostowanego flow dpay | Mały |
| API (headless) | Budujesz własny UI i wysyłasz dane segmentami | Największy, pełna kontrola |
Co możesz robić w imieniu merchanta
Po uzyskaniu delegacji merchanta:
- Odczyt konta - transakcje, rozliczenia, saldo. Plus osadzalna ramka konta dla merchanta.
- Płatności on-behalf - rejestrujesz płatności (np. link do zapłaty za fakturę) w imieniu merchanta.
- Wypłaty on-behalf - zlecasz wypłatę dostępnego salda na rachunek merchanta.
Zakres uprawnień określają scope'y na Twoim kluczu ORAZ zgoda merchanta (delegacja). O tym w kolejnych rozdziałach.
Pierwsze kroki
- Skontaktuj się z dpay, aby zostać partnerem i otrzymać klucz API (
dpk_...) oraz kanał onboardingu. Szczegóły: Onboarding partnera. - Zdecyduj o sposobie onboardingu merchantów (iframe / redirect / API).
- Skonfiguruj webhooki, aby otrzymywać zdarzenia.
- Zacznij onboardować merchantów i obsługiwać ich konta on-behalf.
API partnera (onboarding, odczyt konta, wypłaty) jest dostępne pod https://panel.dpay.pl/api/partner/v1/.... Wyjątek: rejestracja płatności on-behalf to tryb klasycznego endpointu rejestracji na domenie płatności https://api-payments.dpay.pl. Osadzenia (iframe, ramka konta, hosted flow) działają na https://panel.dpay.pl. Dokładne dane dostępowe otrzymasz od dpay przy rejestracji partnera.
Na start dpay może skonfigurować Twoje konto partnera w trybie sandbox: onboardujesz testowych merchantów i przechodzisz cały przepływ, a wypłaty są symulowane (odpowiedź z polem simulated: true, bez realnych przelewów). To bezpieczne środowisko do zbudowania i przetestowania integracji przed przejściem na produkcję.