Moove API
Jedno wywołanie. Płatność w całości.
Utwórz link do płatności z własnego kodu. Klient płaci dowolnym tokenem, a Ty dostajesz pełną kwotę w swoim.
Od klucza do pierwszej płatności.
Utwórz klucz API
W Moove Business utwórz klucz dla Moove Receive Agent. Jest pokazywany raz, więc od razu wstaw go do swojego środowiska.Utwórz link do płatności
Jeden POST zwraca adres URL płatności. Klient płaci tam, dowolnym tokenem, w dowolnej sieci.Dowiedz się, że zapłacono
Zarejestruj endpoint HTTPS, a Moove wyśle mu podpisane zdarzenie w chwili opłacenia linku.
Małe API. Solidne gwarancje.
Dowolny token na wejściu, Twój na wyjściu
Klienci płacą tym, co mają, w ponad 30 sieciach blockchain. Każda płatność trafia do Twojego portfela, w wybranym przez Ciebie tokenie i sieci.Kontrakt, na którym możesz budować
Wersja w ścieżce, w v1 tylko dodatki, z aktualnym schematem OpenAPI.Jasne limity, jasne błędy
Limity na klucz i na IP, zwykłe 429 i jeden kształt błędu ze stabilnymi kodami.Za samo API nic nie płacisz.
Bez abonamentu i bez opłaty za wywołanie. Klient płacący innym tokenem lub w innej sieci pokrywa 0,02%, więc Ty dostajesz pełną kwotę.- Dostęp do API
- Bezpłatny
- Ten sam token, ta sama sieć
- Bezpłatnie
- Między tokenami lub sieciami
- 0,02%
Moove kontra budowa we własnym zakresie.
| Moove kontra budowa we własnym zakresie. | Moove | Budowa we własnym zakresie |
|---|---|---|
| Obsługiwane sieci | MoovePonad 30, z jednego endpointu | Budowa we własnym zakresieOsobna integracja dla każdej sieci |
| Zamiana na Twój token | MooveWbudowana w każdą płatność | Budowa we własnym zakresieWłasny routing wymiany i bridge |
| Wiedza, że płatność dotarła | MoovePodpisane webhooki i endpoint z listą | Budowa we własnym zakresieNasłuchiwacze, które utrzymujesz dla każdej sieci |
| Strona płatności | MooveHostowany link, gotowy do udostępnienia | Budowa we własnym zakresieZaprojektowana, zbudowana i hostowana przez Ciebie |
| Gdy klucz wycieknie | MooveSam nie przeniesie Twoich środków | Budowa we własnym zakresieWszystko, co ma gorący portfel |
Najczęstsze pytania.
Jak zdobyć klucz API?
Zaloguj się do konsoli Moove Business i otwórz klucze API. Nazwij klucz i wybierz Moove Receive Agent, który daje uprawnienie do tworzenia i odczytu linków do płatności. Pełny klucz jest pokazywany raz, przy utworzeniu, i już nigdy więcej, więc zapisz go w menedżerze sekretów. Nie ma endpointu tworzącego klucze, więc jeden klucz nigdy nie wystawi innego.
Dokąd trafiają pieniądze, gdy klient płaci?
Do domyślnego portfela właściciela klucza, w sieci tego portfela i tokenie rozliczeniowym. Wywołujący nie może wskazać innego miejsca docelowego. Dlatego konto potrzebuje zarezerwowanego Moove Handle i domyślnego portfela z tokenem rozliczeniowym przed pierwszym wywołaniem; bez obu utworzenie linku zwraca 409 z informacją, że konto nie jest gotowe do odbierania płatności.
Czy jest API do wypłat?
Tak, Moove Send Agent. Dodaj go do klucza, a API przygotuje wypłatę na dowolny @moovehandle lub adres portfela, w dowolnej sieci, jako niepodpisaną transakcję. Twój agent podpisuje ją i wysyła własnym kluczem, a potem zapisuje przez API. Moove nigdy nie trzyma Twojego klucza podpisującego, więc wyciek klucza API nie pozwoli przenieść Twoich środków. Moove Swap Agent robi to samo dla wymian i bridge’y.
Jak działają webhooki Moove?
Zarejestruj w konsoli do pięciu endpointów HTTPS. Każdy dostaje dwa zdarzenia, jedno, gdy płatność z linku zostanie rozliczona, i drugie, gdy link zostanie zakończony. Dostarczenia są podpisywane HMAC-SHA256 sekretem pokazanym raz. Dostarczanie jest co najmniej raz, więc deduplikuj po id zdarzenia. Nieudane dostarczenie jest ponawiane do sześciu razy.
Czy są limity zapytań?
Tak. Żądania są limitowane na klucz API i na źródłowy adres IP, zależnie od tego, który limit zostanie osiągnięty pierwszy, a przekroczenie zwraca 429. Zwalniaj wykładniczo z odrobiną losowości zamiast ponawiać od razu, bo odrzucone żądania też się liczą. Do statusu płatności używaj webhooków zamiast odpytywać pojedynczy link i pilnuj limitu IP, jeśli kilka integracji dzieli jeden host.
Jak wersjonowane jest API?
W ścieżce. Dziś jest jedna publiczna wersja, v1. Zmiany w obrębie wersji tylko coś dodają, czyli nowe endpointy, nowe opcjonalne pola i nowe pola odpowiedzi. Wszystko, co mogłoby zepsuć klienta, na przykład usunięcie pola lub zmiana typu, trafia do nowej wersji w ścieżce. Zbuduj klienta tak, by ignorował nieznane pola i rozgałęział się po kodach błędów, nigdy po komunikatach.
