Moove API
Eén call. Volledig betaald.
Maak een betaallink vanuit je code. Je klant betaalt in elke token en jij ontvangt het volledige bedrag in de jouwe.
Van sleutel tot eerste betaling.
Maak een API-sleutel aan
Maak in Moove Business een sleutel aan voor de Moove Receive Agent. Die wordt één keer getoond, dus zet hem meteen in je omgeving.Maak een betaallink aan
Eén POST geeft een checkout-URL terug. Je klant betaalt daar, in elke token, op elke chain.Weet wanneer er betaald is
Registreer een HTTPS-endpoint en Moove stuurt er een ondertekend event naartoe zodra een link betaald is.
Kleine API. Stevige garanties.
Elke token erin, de jouwe eruit
Klanten betalen met wat ze hebben, op 30+ blockchainnetwerken. Elke betaling komt in je wallet terecht, in de token en op de chain die jij koos.Een contract om op te bouwen
Versiebeheer in het pad, alleen aanvullend in v1, met een live OpenAPI-schema.Heldere limieten, heldere fouten
Limieten per sleutel en per IP, een duidelijke 429 en één foutformaat met stabiele codes.De API zelf kost niets.
Geen abonnement en geen kosten per call. Een klant die in een andere token of op een andere chain betaalt, draagt de 0,02%, dus jij ontvangt het volledige bedrag.- API-toegang
- Gratis
- Zelfde token, zelfde netwerk
- Gratis
- Tussen tokens of netwerken
- 0,02%
Moove versus het zelf bouwen.
| Moove versus het zelf bouwen. | Moove | Zelf bouwen |
|---|---|---|
| Ondersteunde chains | Moove: 30+, via één endpoint | Zelf bouwen: Eén integratie per chain |
| Omzetten naar jouw token | Moove: Ingebouwd in elke betaling | Zelf bouwen: Je eigen swap- en bridgeroutering |
| Weten dat een betaling binnen is | Moove: Ondertekende webhooks en een lijst-endpoint | Zelf bouwen: Listeners die je voor elke chain draait |
| Checkoutpagina | Moove: Een gehoste link, klaar om te delen | Zelf bouwen: Door jou ontworpen, gebouwd en gehost |
| Als een sleutel uitlekt | Moove: Hij kan alleen betalingen aan jou aanvragen | Zelf bouwen: Alles wat in de hot wallet staat |
Veelgestelde vragen.
Hoe krijg ik een API-sleutel?
Log in op de Moove Business-console en open API-sleutels. Geef de sleutel een naam en kies de Moove Receive Agent, die toestemming geeft om betaallinks aan te maken en te lezen. De volledige sleutel wordt één keer getoond, bij het aanmaken, en daarna nooit meer, dus bewaar hem in een secretmanager. Er is geen endpoint dat sleutels aanmaakt, dus een sleutel kan nooit een andere uitgeven.
Waar gaat het geld heen als een klant betaalt?
Naar de standaardwallet van de eigenaar van de sleutel, op de chain en in de afwikkelingstoken van die wallet. De aanroeper kan geen andere bestemming opgeven. Daarom heeft het account vóór de eerste call een geclaimde Moove handle nodig en een standaardwallet met een afwikkelingstoken; ontbreekt een van beide, dan geeft het aanmaken van een link een 409 terug met de melding dat het account nog geen betalingen kan ontvangen.
Is er een uitbetalings-API?
Nog niet. De API ontvangt betalingen; hij verstuurt ze niet. Om nu leveranciers of freelancers te betalen, gebruik je Versturen in de Moove Business-console. Er is een Moove Send Agent aangekondigd, die in de documentatie verschijnt zodra hij live gaat.
Hoe werken Moove-webhooks?
Registreer tot vijf HTTPS-endpoints in de console. Elk endpoint ontvangt twee events: één wanneer een betaling op een link is afgewikkeld en één wanneer een link is voltooid. Leveringen worden ondertekend met HMAC-SHA256, met een secret die één keer wordt getoond. Levering gebeurt minstens één keer, dus ontdubbel op het event-id. Een mislukte levering wordt tot zes keer opnieuw geprobeerd.
Zijn er rate limits?
Ja. Verzoeken zijn begrensd per API-sleutel en per bron-IP, welke limiet het eerst wordt bereikt, en wie eroverheen gaat krijgt een 429. Gebruik exponentiële backoff met wat jitter in plaats van meteen opnieuw te proberen, want geweigerde verzoeken tellen ook mee. Gebruik webhooks voor de betaalstatus in plaats van één link te pollen, en houd rekening met de IP-limiet als meerdere integraties één host delen.
Hoe wordt de API geversioneerd?
In het pad. Er is nu één publieke versie: v1. Wijzigingen binnen een versie voegen alleen toe: nieuwe endpoints, nieuwe optionele velden, nieuwe responsvelden. Alles wat een client zou breken, zoals een veld verwijderen of een type wijzigen, verschijnt als een nieuwe padversie. Bouw je client zo dat hij onbekende velden negeert en vertakt op foutcodes, nooit op berichten.
