Czego potrzebujesz
| Pole | Do czego służy |
|---|---|
| ID klucza API | Identyfikuje Twój klucz API MakePay, byśmy mogli połączyć się z właściwym kontem. |
| Sekret klucza API | Pozwala nam tworzyć checkouty MakePay na Twoim koncie. Tajny. |
| Sekret webhooka | Potwierdza, że webhook naprawdę pochodzi od MakePay. Tajny. |
| Success URL | Gdzie trafia kupujący po udanej płatności. |
| Failure URL | Gdzie trafia kupujący, gdy płatność się nie udała lub zrezygnował. |
MakePay wydaje ID klucza API i sekret razem przy generowaniu klucza; sekret webhooka to oddzielna wartość w ustawieniach callbacku.
Dlaczego prosimy o każde pole
ID klucza API
Określa, którym kluczem MakePay się uwierzytelniamy. Nie jest tajny sam w sobie, ale sparowany jest z sekretem poniżej.
Sekret klucza API
Autoryzuje utworzenie checkoutu, by płatność przeszła na Twoje konto MakePay i trafiła do Twojego portfela. MakePay pokazuje go raz, zaraz po wygenerowaniu klucza.
Sekret webhooka
Dowodzi, że przychodzący webhook naprawdę pochodzi od MakePay, by nikt nie mógł sfałszować zdarzenia "opłacono". To wartość odrębna od klucza API.
Success i Failure URL
Zwykłe ustawienia: gdzie trafia kupujący po udanej płatności lub po nieudanej/rezygnacji. Nie są tajne.
Konfiguracja
- Wygeneruj klucz API w MakePay
Zaloguj się do MakePay i otwórz API & SDK → API integrations. W sekcji API keys kliknij Generate API Key, nadaj mu nazwę, na przykład "Coin Moebius", i utwórz go. MakePay pokazuje ID klucza API i jego sekret raz, zaraz po wygenerowaniu — skopiuj oba teraz, bo sekret nie będzie pokazywany ponownie.
MakePay → API & SDK → API integrations → Generate API Key Traktuj sekret klucza API jak hasło. Jeśli go stracisz, wygeneruj nowy klucz zamiast próbować odzyskać stary.
- Znajdź identyfikator projektu Coin Moebius
W oddzielnej karcie otwórz swój projekt w panelu Coin Moebius i skopiuj ID projektu spod nazwy projektu. Adres callback webhoooka MakePay to ten ID wstawiony w adres poniżej — wklejisz go do MakePay w następnym kroku.
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → Twój projekt → Project ID Karta podłączonego dostawcy (ostatni krok) pokazuje ten sam adres URL, więc możesz go skopiować ponownie w dowolnym momencie.
- Ustaw adres URL callbacku i skopiuj sekret webhooka
Wróć do MakePay, przewiń do Delivery → Callback URL configuration. Kliknij Edit Callback URL, wklej swój adres webhook Coin Moebius jako aktywne miejsce docelowe i zapisz. Potem w sekcji Webhook signing skopiuj sekret podpisywania (użyj Regenerate secret, jeśli jeszcze nie ma wartości) — to sekret webhooka, którego MakePay od Ciebie żąda.
MakePay → Delivery → Callback URL configuration MakePay wysyła aktualizacje dostawy na ten adres po każdej zmianie statusu widocznej dla kupującego. Sekret podpisywania jest oddzielny od klucza API — potrzebujesz obydwu.
- Podłącz w panelu Coin Moebius
W Coin Moebius otwórz Providers → Add provider → MakePay. Wklej ID klucza API, sekret klucza API i sekret webhooka, a następnie ustaw Success URL i Failure URL (gdzie kupujący trafiają po udanej lub nieudanej płatności). Kliknij Save.
Coin Moebius → Add provider → MakePay Zapisane sekrety pozostają ukryte. Aby zmienić jeden z nich później, wybierz Replace i wpisz nową wartość.
- Jesteś podłączony
MakePay pojawia się teraz w zakładce Providers z datą podłączenia i adresem URL webhooka, którego oczekuje. Jeśli jeszcze tego nie zrobiłeś, wklej ten adres URL w ustawienia callbacku MakePay. Użyj Edit, by rotować klucze, lub Disconnect, by go usunąć, a przełącznik Test mode, by przeprowadzić zamówienie bez wpływu na rzeczywiste liczby.
Coin Moebius → Providers → MakePay (podłączony)
Po podłączeniu
Przeprowadź jedno zamówienie przed wejściem na żywo:
- Włącz przełącznik Test mode na podłączonej karcie MakePay, by przeprowadzić zamówienie bez wpływu na rzeczywiste liczby.
- Utwórz produkt i umieść przycisk kupna na stronie (wystarczy lokalny plik HTML) wskazujący na Twój projekt.
- Dokończ checkout przez MakePay.
- Otwórz zakładkę Transactions. Gdy status nowego wiersza osiągnie succeeded, Twoje klucze i webhook działają od początku do końca.
Wyłącz Test mode, gdy będziesz gotowy na prawdziwe płatności.
Rozwiązywanie problemów
Zacznij od panelu: potwierdź, że karta MakePay pokazuje status podłączony i że adres URL webhooka pasuje do miejsca docelowego callbacku zapisanego w MakePay.
Płatność się kończy, ale zamówienie pozostaje pending.
Webhook nie dociera lub się nie weryfikuje. Potwierdź, że adres URL callbacku w MakePay dokładnie pasuje do adresu webhook projektu, a sekret webhooka w Coin Moebius pasuje do sekretu podpisywania w MakePay.
Zapis dostawcy jest odrzucany.
ID klucza API, sekret klucza API i sekret webhooka są wymagane. Skopiuj je ponownie z MakePay — sekret jest pokazywany tylko raz, więc wygeneruj nowy klucz, jeśli już go nie masz.
Testowe zamówienie nigdy się nie pojawia w Transactions.
Włącz przełącznik Test mode na karcie MakePay zanim uruchomisz przycisk kupna, i upewnij się, że produkt wskazuje na ten sam projekt.
Warto wiedzieć
Brak opiekuna. MakePay wprowadza krypto prosto na Twój własny portfel. Coin Moebius nigdy nie trzyma pieniędzy i nie może nimi manipulować.
Rotacja sekretów. Wygeneruj nowy klucz API lub regeneruj sekret podpisywania webhooka w dowolnym momencie, a następnie wybierz Replace w panelu i wklej nową wartość. Pola tajne pozostają puste przy edycji.
Pytania? Join our Discord