PayPal

Czego potrzebujesz

Dlaczego prosimy o każde pole

Client ID

Identyfikuje Twoją aplikację PayPal przy wywołaniach API. Działa tylko w parze z Client secret.

Client secret

Prywatna połowa uwierzytelniania API. Razem z Client ID pozwala nam utworzyć zamówienie, by płatność przeszła przez Twoje konto.

Webhook ID

Jak potwierdzamy, że webhook naprawdę pochodzi od PayPal: PayPal identyfikuje każdy webhook identyfikatorem, a my używamy go, by zapytać PayPal bezpośrednio, czy dana wiadomość jest autentyczna. To powstrzymuje kogokolwiek od sfałszowania zdarzenia "opłacono".

Success URL i Cancel URL

Zwykłe ustawienia: gdzie trafia kupujący po zapłacie lub rezygnacji. Nie są tajne.

Konfiguracja

1. Otwórz panel PayPal Developer

   Zaloguj się na developer.paypal.com. PayPal daje Ci darmowy Sandbox z fałszywymi kontami firmowymi i kupującego, dzięki czemu możesz testować bez przenoszenia prawdziwych pieniędzy. Ten przewodnik prowadzi przez Sandbox; przebieg Live jest identyczny, wystarczy przełączyć przełącznik Sandbox / Live (górny lewy róg) i użyć konta PayPal for Business. Z panelu otwórz Apps & Credentials.

   ⤢
2. Utwórz aplikację

   Na stronie API Credentials potwierdź, że wybrany jest przełącznik Sandbox, a następnie kliknij Create App (górny prawy róg).

   ⤢
3. Nazwij ją i wybierz Merchant

   Wpisz App Name (na przykład "Coin Moebius"), pozostaw Type na Merchant, wybierz swoje testowe konto firmowe i kliknij Create App.

   ⤢
4. Skopiuj swój Client ID i Client secret

   PayPal otwiera Twoją nową aplikację. Skopiuj Client ID oraz odkryj i skopiuj Secret key. (Możesz też skopiować oba z wiersza Default Application na liście API Credentials.) Zachowaj je.

   ⤢

   ⤢

   Client secret jest tajny, traktuj go jak hasło. Aplikacja sandbox i aplikacja live mają każda własną parę, więc ich nie mieszaj.

5. Dodaj webhook

   Przewiń stronę aplikacji do sekcji Sandbox Webhooks i kliknij Add Webhook. W polu Webhook URL wklej adres webhooka PayPal Twojego projektu (poniżej). Następnie wybierz zdarzenia, których Coin Moebius nasłuchuje, i kliknij Save.

   • Płatności jednorazowe: CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED.
   • Subskrypcje (tylko jeśli je sprzedajesz): BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED. Jeśli nie rozliczasz cyklicznie, pomiń je.
   • W pośpiechu? Wybranie All Events (wildcard na górze) też zadziała, ignorujemy wszystko, czego nie używamy.

   https://api.coinmoebius.com/webhook/paypal/<your project id>

   ⤢

   Identyfikator Twojego projektu znajduje się pod nazwą projektu w panelu Coin Moebius; wstaw go do powyższego adresu. Karta podłączonego dostawcy (ostatni krok) pokazuje ten sam adres URL w celach informacyjnych.

6. Skopiuj Webhook ID

   Twój webhook pojawia się teraz na liście Sandbox Webhooks. Skopiuj Webhook ID wyświetlony obok niego. W ten sposób Coin Moebius pyta PayPal, czy dana wiadomość jest autentyczna. Zarejestruj osobny webhook w sandbox i w live.

   ⤢
7. W Coin Moebius: Add provider → PayPal

   W swoim projekcie otwórz zakładkę Providers, kliknij Add provider, wybierz Connect a service i wybierz PayPal. Ustaw Success URL i Cancel URL. Testujesz z poświadczeniami sandbox? Użyj zakładki Test (opcjonalnej) i wklej tam Client ID, Client secret i Webhook ID, a następnie kliknij Save. Przechodzisz od razu do live? Użyj zakładki Live. Grupa Test działa na zasadzie wszystko albo nic: wszystkie trzy pola, albo żadne.

   ⤢
8. Jesteś podłączony

   PayPal pojawia się teraz na zakładce Providers z datą podłączenia (oznaczone TEST, gdy użyłeś poświadczeń sandbox). Karta pokazuje ten sam adres URL webhooka, który wkleiłeś do PayPal, oraz przyciski Edit i Disconnect.

   ⤢
9. Testuj z kupującym sandbox

   Aby zapłacić przez testowy checkout, potrzebujesz loginu kupującego sandbox. W PayPal otwórz Testing Tools → Sandbox Accounts, by zobaczyć swoje fałszywe konta Business i Personal.

   ⤢
10. Pobierz dane logowania kupującego

    Otwórz konto Personal (kupującego), by zobaczyć jego Login Info: adres URL sandbox, e-mail i hasło. Zaloguj się na sandbox.paypal.com tymi danymi, gdy testowy checkout poprosi o zapłatę. Żadne prawdziwe pieniądze się nie przemieszczają.

    ⤢

Po podłączeniu

Wykonaj jedną płatność testową przed wejściem na żywo:

1. Utwórz produkt i ustaw jego Environment na Testing. To uruchamia produkt na Twoich poświadczeniach sandbox, więc możesz złożyć pełne zamówienie bez przepływu pieniędzy. (Jeśli pominąłeś zestaw sandbox, produkt Testing wraca do live, więc najpierw go dodaj.)
2. Umieść przycisk kupna na stronie (wystarczy lokalny plik HTML) wskazującej na Twój projekt.
3. Dokończ checkout, płacąc swoim kontem kupującego sandbox.
4. Otwórz zakładkę Transactions. Pojawi się nowy wiersz z etykietą Testing. Gdy jego status osiągnie succeeded, Twoje poświadczenia i webhook działają od początku do końca.

Przełącz Environment produktu na Live, gdy będziesz gotowy na prawdziwe płatności.

Rozwiązywanie problemów

Zacznij od Verify. W panelu kliknij Verify (lub Verify test credentials dla sandboxa), by sprawdzić swoje poświadczenia klienta.

Verify się nie udaje.

Skopiuj ponownie Client ID i Client secret. Aplikacja sandbox i aplikacja live mają różne pary, więc ich nie mieszaj.

Płatność się kończy, ale zamówienie pozostaje pending.

Webhook ID musi pochodzić z tej samej aplikacji i środowiska co Twoje poświadczenia klienta. Poświadczenia live wymagają webhook ID z live. Potwierdź, że adres URL webhooka się zgadza.

Potwierdź od początku do końca.

PayPal Developer Dashboard → Webhooks Simulator: wyślij przykładowe zdarzenie na swój adres URL webhooka, a potem obserwuj aktualizację zamówienia.

Warto wiedzieć

Rotacja sekretów. Wygeneruj nowy client secret kiedy chcesz, a potem wklej go. Pola tajne pozostają puste przy edycji.

Pytania? Join our Discord