~/stack/paypal · stack

PayPal w koszyku — jednorazowo, raty / pay later gdy dostępne, i API zamówień.

Jeśli szukasz «jak zintegrować PayPal na stronie», «PayPal developer» lub różnicy hosted vs Orders API — poniżej masz obraz sytuacji, także gdy PayPal udostępnia raty albo kup teraz zapłać później (zależy od kraju progów i oceny klienta): wdrażamy spójny checkout backend i webhooki z zamówieniem.

Jak to działa (krótko)

PayPal ustawia kupującego przy portfelu: po akceptacji dostajesz od platformy potwierdzenie zamówienia lub płatności do powiązania z rekordem po stronie serwera. Front: przycisk albo redirect; backend: tworzenie i domykanie zamówienia, synchronizacja magazynu i fakturowania.

Względem samej karty PayPal często buduje zaufanie i skraca ścieżkę dla osób z kontem. Opłaty, kraje i regulamin zależą od oferty i konta merchanta — działamy w ramach Twojego kontraktu i aktualnej dokumentacji.

Gdzie PayPal to udostępnia możliwe są też raty lub odroczona płatność (nazwa i zasady zależą od rynku): nadal finalizujesz jedną transakcję z potwierdzeniem API/webhook jak przy zwykłej płatności.

WWW: gotowy checkout czy custom API?

Hosted / komponenty oficjalne: szybszy start, mniejsza powierzchnia utrzymania na froncie.

REST / Orders, gdy potrzebujesz pełnej kontroli (kwoty, waluty, logistyka, marketplace): sesje z serwera, idempotencja tam, gdzie trzeba, spójne komunikaty błędów w koszyku.

  • Nie ma jednej uniwersalnej decyzji: UX, współistnienie PSP i to, czy metody trzymasz tylko u operatora — to wpływa na wybór.
  • Przy ratach / pay later spójnie ustawiamy komunikaty w koszyku progi UX i stan zamówienia po redirectach i webhookach żeby nie obiecywać opcji których flow później nie dokończy.
  • Sekrety i webhooki zostają poza przeglądarką: mniejsze ryzyko, prostsze przeglądy.

Gdzie integrujemy

  • Sklepy WWW, PWA i headless: koszyk w JS, finalizacja z podpisem klienta i potwierdzeniem serwera.
  • Subskrypcje / płatności cykliczne — tylko gdy produkt i ramy prawne to dopuszczają; weryfikujemy z góry.
  • Aplikacje iOS/Android przy wspieranym flow: SDK, deep link, return URL i spójny backend.
  • Platformy multi-vendor: często programy partnerskie lub dedykowana ścieżka z PayPal — oceniamy na discovery.

Co robimy jako developerzy

  • Discovery: koszyk, sandbox/live, waluty, zwroty i co ma się stać po CAPTURE albo równoważnym zdarzeniu.
  • Implementacja: tworzenie zamówień, return URL, anulacje, obsługa błędów, webhook z weryfikacją podpisu i zapis w Twojej domenie aplikacyjnej.
  • Testy w sandbox, checklist przed produkcją, logi z correlation id, przekazanie zespołowi.
  • Po starcie: zmiany API, storefront, współistnienie z innymi PSP i metodami płatności.

Masz wątpliwości? Zapytaj.

FAQ

Wystarczy wkleić skrypt z przyciskiem PayPal?
Czasem tak na demo. W produkcji prawie zawsze backend tworzy zamówienie, potwierdza status i aktualizuje stany. Sam skrypt wklejony w front słabo znosi dynamiczne kwoty i reguły antyfraudowe po stronie serwera.
Czy PayPal ma sens obok Stripe lub banku?
Zależy od mixu klientów, krajów, opłat i kosztu utrzymania kodu. Pomagamy porównać na konkretnych liczbach, nie pod logo.
Czy mogę dać klientom raty / «kup teraz zapłać później» przez PayPal?
Tylko tam gdzie PayPal i Twoja umowa włączają produkt na danym rynku i klient przejdzie ocenę w momencie płatności. Wtedy opcja pojawia się w oficjalnym checkoutcie my pilnujemy spójności komunikatów zamówień webhooków i zwrotów według dokumentacji.
Do czego sandbox?
Środowisko testowe bez prawdziwych środków: symulacja zatwierdzeń, zwrotów i webhooków — mniej regresji przy zmianach po stronie PayPal i sklepu.
Czy klient zostaje na mojej domenie?
Zależy od wybranego flow (in-page, redirect, mobile). Ustalamy UX i wymagania techniczne wcześniej, żeby ekran zgody PayPal nie był niespodzianką przy starcie.
Pracujecie na naszym koncie PayPal?
Tak z dostępami delegowanymi Ty jesteś właścicielem konta i relacji z PayPal.
Ile trwa?
Prosty checkout na już uporządkowanym sklepie to często kilka dni; starszy lub złożony kod i marketplace wydłużają pracę. Po przeglądzie flow podajemy sensowne widełki.