Czego potrzebujesz
| Pole | Do czego służy |
|---|---|
| API key | Pozwala nam wywołać Dodo, by utworzyć hostowany checkout. Tajny. |
| Webhook signing secret (whsec_…) | Potwierdza, że webhook naprawdę pochodzi od Dodo. Tajny. |
| Return URL | Gdzie trafia kupujący po checkoucie. |
Dlaczego prosimy o każde pole
API key
Autoryzuje utworzenie hostowanego checkoutu, by obciążenie przeszło przez Twoje konto.
Webhook signing secret
Dowodzi, że przychodzący webhook naprawdę pochodzi od Dodo, by nikt nie mógł sfałszować zdarzenia "opłacono". To wartość odrębna od API key.
Return URL
Zwykłe ustawienie: gdzie trafia kupujący po checkoucie. Nie jest tajne.
Konfiguracja
- Użyj trybu testowego (za darmo)
Dodo ma osobne środowisko testowe. Klucze w trybie testowym działają względem hosta testowego Dodo i żadne prawdziwe pieniądze się nie przemieszczają.
- Zaloguj się na app.dodopayments.com.
- Dodo rozdziela klucze Live i Test. Skonfiguruj najpierw test, potem powtórz w live.
- Skopiuj swój API key
Przejdź do Developer → API Keys i skopiuj klucz Test, by zweryfikować, lub klucz Live, by przyjmować prawdziwe płatności.
Dodo → Developer → API Keys - Dodaj webhook
- Dodaj webhook w Dodo.
- Ustaw adres URL webhooka na adres webhooka Twojego projektu (poniżej).
- Skopiuj webhook signing secret (whsec_…). Dodaj osobny webhook w test i w live.
https://api.coinmoebius.com/webhook/dodopayments/<your project id>Dodo → Developer → Webhooks - Podłącz w panelu
Add provider → Dodo Payments. Wpisz Return URL oraz grupę Live (Live API key, Live webhook signing secret). Dodaj opcjonalną grupę Test, by najpierw zweryfikować. Grupa Test jest sparowana: dodaj zarówno testowy API key, jak i testowy sekret webhooka, albo zostaw oba puste. Live i test sprawdzane są osobno.
Po podłączeniu
Wykonaj jedną płatność testową przed wejściem na żywo:
- Utwórz produkt i ustaw jego Environment na Testing. To uruchamia produkt na Twoich poświadczeniach testowych, więc możesz złożyć pełne zamówienie bez przepływu pieniędzy. (Jeśli pominąłeś zestaw testowy, produkt Testing wraca do live, więc najpierw go dodaj.)
- Umieść przycisk kupna na stronie (wystarczy lokalny plik HTML) wskazującej na Twój projekt.
- Dokończ checkout w trybie testowym Dodo.
- 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), by sprawdzić swój API key.
Verify test credentials mówi, że nie zapisano poświadczeń testowych.
Dodaj testowy API key w zakładce Test, zapisz dostawcę, a potem ponownie otwórz okno i zweryfikuj.
Płatność się kończy, ale zamówienie pozostaje pending.
Potwierdź, że adres URL webhooka się zgadza i że signing secret pasuje do webhooka w tym samym środowisku (sekret testowy dla test, live dla live).
Zapis grupy Test jest odrzucany.
Grupa Test jest sparowana: dodaj zarówno testowy API key, jak i testowy sekret webhooka, albo zostaw oba puste.
Potwierdź od początku do końca.
Dodo Dashboard → Developer → Webhooks → Send Example (lub Dodo CLI) skierowane na Twój adres URL webhooka, a potem obserwuj aktualizację zamówienia.
Warto wiedzieć
Tylko płatności jednorazowe. Coin Moebius używa Dodo do pojedynczych płatności, a nie subskrypcji.
Rotacja sekretów. Zmieniaj API key lub sekret webhooka kiedy chcesz, a potem wklej nową wartość. Pola tajne pozostają puste przy edycji.
Pytania? Join our Discord