Moove API
Ein Aufruf. Voll bezahlt.
Erstelle einen Zahlungslink aus deinem Code. Dein Kunde zahlt in einem beliebigen Token, und du erhältst den vollen Betrag in deinem.
Vom Schlüssel zur ersten Zahlung.
API-Schlüssel erstellen
Erstelle in Moove Business einen Schlüssel für den Moove Receive Agent. Er wird nur einmal angezeigt, trage ihn also gleich in deine Umgebung ein.Zahlungslink erstellen
Ein POST liefert eine Checkout-URL. Dein Kunde zahlt dort, in einem beliebigen Token, auf einer beliebigen Chain.Erfahren, wann bezahlt wurde
Registriere einen HTTPS-Endpunkt, und Moove schickt ihm ein signiertes Ereignis, sobald ein Link bezahlt ist.
Kleine API. Solide Garantien.
Jeder Token rein, deiner raus
Kunden zahlen mit dem, was sie halten, über mehr als 30 Blockchain-Netzwerke. Jede Zahlung wird in deiner Wallet abgerechnet, in dem Token und auf der Chain, die du gewählt hast.Ein Vertrag, auf dem du bauen kannst
Im Pfad versioniert, in v1 nur erweiternd, mit einem aktuellen OpenAPI-Schema.Klare Limits, klare Fehler
Limits pro Schlüssel und pro IP, ein schlichtes 429 und ein einheitliches Fehlerformat mit stabilen Codes.Keine Gebühr für die API selbst.
Kein Abo und keine Gebühr pro Aufruf. Ein Kunde, der in einem anderen Token oder auf einem anderen Netzwerk zahlt, trägt die 0,02 %, sodass du den vollen Betrag erhältst.- API-Zugang
- Kostenlos
- Gleicher Token, gleiches Netzwerk
- Kostenlos
- Zwischen Token oder Netzwerken
- 0,02 %
Moove im Vergleich zum Selbstbau.
| Moove im Vergleich zum Selbstbau. | Moove | Selbst bauen |
|---|---|---|
| Abgedeckte Chains | Moove30+, über einen Endpunkt | Selbst bauenEine Integration pro Chain |
| Umwandlung in deinen Token | MooveIn jede Zahlung eingebaut | Selbst bauenDein eigenes Swap- und Bridge-Routing |
| Wissen, dass eine Zahlung angekommen ist | MooveSignierte Webhooks und ein Listen-Endpunkt | Selbst bauenListener, die du für jede Chain betreibst |
| Checkout-Seite | MooveEin gehosteter Link, bereit zum Teilen | Selbst bauenVon dir entworfen, gebaut und gehostet |
| Wenn ein Schlüssel offengelegt wird | MooveEr kann deine Gelder nicht allein bewegen | Selbst bauenWas auch immer die Hot Wallet hält |
Häufige Fragen.
Wie bekomme ich einen API-Schlüssel?
Melde dich in der Moove-Business-Konsole an und öffne API-Schlüssel. Gib dem Schlüssel einen Namen und wähle den Moove Receive Agent, der die Berechtigung gibt, Zahlungslinks zu erstellen und zu lesen. Der vollständige Schlüssel wird nur einmal bei der Erstellung angezeigt und danach nie wieder, speichere ihn also in einem Secret Manager. Es gibt keinen Endpunkt, der Schlüssel erstellt, daher kann ein Schlüssel nie einen anderen ausstellen.
Wohin geht das Geld, wenn ein Kunde zahlt?
An die Standard-Wallet des Schlüsselinhabers, in der Chain und dem Abrechnungs-Token dieser Wallet. Der Aufrufer kann kein anderes Ziel angeben. Deshalb braucht das Konto vor dem ersten Aufruf einen beanspruchten Moove Handle und eine Standard-Wallet mit Abrechnungs-Token. Fehlt eines davon, gibt das Erstellen eines Links einen 409 zurück, der besagt, dass das Konto noch nicht bereit ist, Zahlungen zu empfangen.
Gibt es eine Auszahlungs-API?
Ja, der Moove Send Agent. Füge ihn einem Schlüssel hinzu, und die API bereitet eine Auszahlung an einen beliebigen @moovehandle oder eine Wallet-Adresse auf jeder Chain vor, als unsignierte Transaktion. Dein Agent signiert und sendet sie mit deinem eigenen Schlüssel und erfasst sie dann über die API. Moove hält nie deinen Signaturschlüssel, daher kann ein offengelegter API-Schlüssel deine Gelder nicht allein bewegen. Der Moove Swap Agent macht dasselbe für Swaps und Bridges.
Wie funktionieren Moove-Webhooks?
Registriere in der Konsole bis zu fünf HTTPS-Endpunkte. Jeder erhält zwei Ereignisse, eines, wenn eine Zahlung auf einen Link abgewickelt ist, und eines, wenn ein Link abgeschlossen ist. Die Zustellungen werden mit HMAC-SHA256 und einem einmalig angezeigten Secret signiert. Die Zustellung erfolgt mindestens einmal, dedupliziere also anhand der Ereignis-ID. Eine fehlgeschlagene Zustellung wird bis zu sechsmal wiederholt.
Gibt es Rate Limits?
Ja. Anfragen sind pro API-Schlüssel und pro Quell-IP begrenzt, je nachdem, was zuerst erreicht wird, und bei Überschreitung kommt 429 zurück. Warte exponentiell mit etwas Jitter, statt sofort erneut zu versuchen, denn abgelehnte Anfragen zählen trotzdem. Nutze Webhooks für den Zahlungsstatus, statt einen einzelnen Link abzufragen, und plane gegen das IP-Limit, wenn mehrere Integrationen einen Host teilen.
Wie wird die API versioniert?
Im Pfad. Aktuell gibt es eine öffentliche Version, v1. Änderungen innerhalb einer Version ergänzen nur neue Endpunkte, neue optionale Felder und neue Antwortfelder. Alles, was einen Client brechen würde, etwa das Entfernen eines Felds oder das Ändern eines Typs, erscheint als neue Pfadversion. Baue deinen Client so, dass er unbekannte Felder ignoriert und anhand von Fehlercodes verzweigt, nie anhand von Meldungen.
