Czego potrzebujesz
| Pole | Do czego służy |
|---|---|
| API key | Pozwala nam wywołać NOWPayments, by utworzyć płatność. Tajny. |
| IPN secret | Potwierdza, że powiadomienie o płatności naprawdę pochodzi od NOWPayments. Tajny. |
| Success URL / Cancel URL | Gdzie trafia kupujący po zapłacie lub rezygnacji. |
IPN (Instant Payment Notification) to nazwa NOWPayments na webhook, który wysyłają, gdy zmienia się status płatności.
Dlaczego prosimy o każde pole
API key
Autoryzuje utworzenie płatności, by środki trafiły na Twoje konto.
IPN secret
Dowodzi, że przychodzące powiadomienie naprawdę pochodzi od NOWPayments, by nikt nie mógł sfałszować zdarzenia "opłacono". To wartość odrębna od API key.
Success URL i Cancel URL
Zwykłe ustawienia: gdzie trafia kupujący po zapłacie lub rezygnacji. Nie są tajne.
Konfiguracja
- Testowanie: nie ma sandboxa
NOWPayments nie ma sandboxa ani środowiska testowego. Aby zweryfikować od początku do końca, wyślij małą prawdziwą płatność w monecie o niskiej prowizji i potwierdź, że pojawia się w Twoim panelu. Potraktuj tę pierwszą małą płatność jako swój test. Konto NOWPayments jest darmowe; płacisz tylko zwykłe opłaty sieciowe i serwisowe przy prawdziwych płatnościach.
- Otwórz Payments Settings w NOWPayments
Zaloguj się na account.nowpayments.io i przejdź do Settings → Payments. Ten jeden ekran zawiera trzy rzeczy, których potrzebujesz: Payout wallets (gdzie trafiają środki), API keys i Instant payment notifications. Odwiedzisz każdą z nich po kolei.
NOWPayments → Settings → Payments - Dodaj portfel wypłat
NOWPayments odblokowuje API dopiero po podaniu portfela wypłat. W Payout wallets kliknij Add new wallet, wybierz walutę, wklej adres portfela, który kontrolujesz, i kliknij Add wallet. To adres, na który trafia Twoje krypto.
NOWPayments → Payout wallets → Add new wallet - Utwórz API key
Otwórz API keys i kliknij Add new API key. Klucze są tu wylistowane, każdy z ikoną kopiowania, więc możesz wrócić i skopiować klucz w dowolnym momencie.
NOWPayments → Settings → API keys - Skopiuj swój API key
NOWPayments pokazuje nowy klucz w oknie dialogowym "API key created". Kliknij ikonę kopiowania obok Your API key i zachowaj go. (Klucz publiczny poniżej nie jest potrzebny przez Coin Moebius.) Możesz dodać opcjonalną etykietę, a następnie kliknąć Save.
NOWPayments → API key created To jest Twój tajny API key. Traktuj go jak hasło.
- Skonfiguruj callback IPN i skopiuj sekret IPN
Otwórz Instant payment notifications. IPN (Instant Payment Notification) to nazwa NOWPayments na webhook wysyłany przy zmianie statusu płatności.
- W polu Webhook URL wklej adres webhooka NOWPayments Twojego projektu (poniżej), a następnie kliknij Save.
- Skopiuj IPN secret key pokazany na górze (kliknij Regenerate, jeśli nie ma jeszcze wartości).
- W sekcji Choose webhook format wybierz Classic way, by kwoty i identyfikatory pozostały w normalnym formacie liczbowym.
https://api.coinmoebius.com/webhook/nowpayments/<your project id>NOWPayments → Instant payment notifications 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, więc możesz go skopiować ponownie w dowolnym momencie.
- W Coin Moebius: Add provider → NOWPayments
W swoim projekcie otwórz zakładkę Providers, kliknij Add provider, wybierz Connect a service i wybierz NOWPayments. Wklej swój API key i IPN secret, ustaw Success URL i Cancel URL (gdzie kupujący trafiają po zapłacie lub rezygnacji), a następnie kliknij Save.
Coin Moebius → Add provider → NOWPayments - Jesteś podłączony
NOWPayments pojawia się teraz na zakładce Providers z datą podłączenia. Karta pokazuje ten sam adres URL webhooka, który wkleiłeś do NOWPayments, oraz przyciski Edit i Disconnect. Ponieważ NOWPayments nie ma sandboxa, nie możemy automatycznie zweryfikować IPN secret, więc karta oferuje test mikropłatności: wyślij małą prawdziwą płatność, by potwierdzić, że wszystko działa od początku do końca.
Coin Moebius → Providers → NOWPayments (podłączony)
Po podłączeniu
Nie ma sandboxa, więc Twoja pierwsza mała prawdziwa płatność jest testem:
- Utwórz produkt i umieść przycisk kupna na stronie (wystarczy lokalny plik HTML) wskazującej na Twój projekt.
- Zapłać małą kwotę w monecie o niskiej prowizji.
- Otwórz zakładkę Transactions. Gdy status nowego wiersza osiągnie succeeded, Twój API key i IPN secret działają od początku do końca.
Rozwiązywanie problemów
Płatność się kończy, ale zamówienie pozostaje pending.
IPN nie dociera lub się nie weryfikuje. Potwierdź, że callback URL się zgadza i że IPN secret w panelu pasuje do IPN Secret Key w ustawieniach NOWPayments.
Brak sposobu na testowanie bez płacenia.
Zgadza się, nie ma sandboxa. Wyślij małą prawdziwą płatność w monecie o niskiej prowizji, by wywołać prawdziwy IPN, a potem obserwuj aktualizację zamówienia.
Status zmienia się tylko przy prawdziwej aktywności.
Status NOWPayments odzwierciedla dostawy IPN, więc ciche konto nie pokazuje statusu, dopóki nie przejdzie prawdziwa płatność.
Warto wiedzieć
Brak trybu testowego. Weryfikuj małą prawdziwą płatnością, a nie sandboxem.
Rotacja sekretów. Wygeneruj nowy API key lub IPN secret kiedy chcesz, a potem wklej nową wartość.
Pytania? Join our Discord