Moove API
Un apel. Plătit integral.
Creează un link de plată din codul tău. Clientul tău plătește în orice token, iar tu primești suma întreagă în al tău.
De la cheie la prima plată.
Creează o cheie API
În Moove Business, creează o cheie pentru Moove Receive Agent. Se afișează o singură dată, așa că pune-o direct în mediul tău.Creează un link de plată
Un singur POST returnează un URL de plată. Clientul tău plătește acolo, în orice token, pe orice rețea.Află când e plătit
Înregistrează un endpoint HTTPS, iar Moove îi trimite un eveniment semnat în clipa în care un link este plătit.
API mic. Garanții solide.
Orice token intră, al tău iese
Clienții plătesc cu ce dețin, pe peste 30 de rețele blockchain. Fiecare plată se decontează în portofelul tău, în tokenul și pe rețeaua pe care le-ai ales.Un contract pe care poți construi
Versionat în cale, doar cu adăugiri în v1, cu o schemă OpenAPI actualizată permanent.Limite clare, erori clare
Limite pe cheie și pe IP, un 429 simplu și o singură formă de eroare cu coduri stabile.Fără comision pentru API în sine.
Fără abonament și fără comision pe apel. Un client care plătește în alt token sau pe altă rețea acoperă cei 0,02%, așa că tu primești suma întreagă.- Acces la API
- Gratuit
- Același token, aceeași rețea
- Gratuit
- Între tokenuri sau rețele
- 0,02%
Moove vs să construiești singur.
| Moove vs să construiești singur. | Moove | Construit intern |
|---|---|---|
| Rețele acoperite | MoovePeste 30, dintr-un singur endpoint | Construit internO integrare pentru fiecare rețea |
| Conversia în tokenul tău | MooveInclusă în fiecare plată | Construit internPropriul tău rutaj pentru schimb și transfer între rețele |
| Aflarea că o plată a ajuns | MooveWebhookuri semnate și un endpoint de listare | Construit internListeners pe care îi rulezi pentru fiecare rețea |
| Pagina de plată | MooveUn link găzduit, gata de partajat | Construit internProiectată, construită și găzduită de tine |
| Dacă o cheie se scurge | MooveNu îți poate muta singură fondurile | Construit internOrice conține portofelul hot |
Întrebări frecvente.
Cum obțin o cheie API?
Conectează-te la consola Moove Business și deschide Chei API. Dă-i un nume cheii și alege Moove Receive Agent, care acordă permisiunea de a crea și citi linkuri de plată. Cheia completă se afișează o singură dată, la creare, și niciodată după aceea, așa că păstreaz-o într-un secret manager. Nu există un endpoint care să creeze chei, deci o cheie nu poate emite niciodată alta.
Unde ajung banii când plătește un client?
În portofelul implicit al proprietarului cheii, în rețeaua acelui portofel și în tokenul lui de decontare. Cel care apelează nu poate indica altă destinație. De aceea contul are nevoie de un handle Moove revendicat și de un portofel implicit cu un token de decontare înainte de primul apel; fără ambele, crearea unui link returnează un 409 care spune că contul nu este pregătit să primească plăți.
Există un API pentru plăți către alții?
Da, Moove Send Agent. Adaugă-l la o cheie, iar API-ul pregătește o plată către orice @moovehandle sau adresă de portofel, în orice rețea, ca tranzacție nesemnată. Agentul tău o semnează și o transmite cu propria ta cheie, apoi o înregistrează prin API. Moove nu deține niciodată cheia ta de semnare, așa că o cheie API scursă nu îți poate muta singură fondurile. Moove Swap Agent face același lucru pentru schimburi și transferuri între rețele.
Cum funcționează webhookurile Moove?
Înregistrează în consolă până la cinci endpointuri HTTPS. Fiecare primește două evenimente, unul când se decontează o plată pe un link și unul când un link se încheie. Livrările sunt semnate cu HMAC-SHA256, folosind un secret afișat o singură dată. Livrarea este cel puțin o dată, așa că elimină duplicatele după id-ul evenimentului. O livrare eșuată se reîncearcă de până la șase ori.
Există limite de cereri?
Da. Cererile sunt limitate pe cheie API și pe IP sursă, oricare se atinge prima, iar depășirea returnează 429. Încearcă din nou exponențial, cu puțin jitter, nu imediat, pentru că cererile respinse se numără și ele. Folosește webhookuri pentru starea plății, în loc să interoghezi repetat un singur link, și ține cont de limita pe IP dacă mai multe integrări folosesc același host.
Cum este versionat API-ul?
În cale. Astăzi există o singură versiune publică, v1. Modificările din interiorul unei versiuni doar adaugă endpointuri noi, câmpuri opționale noi și câmpuri noi în răspuns. Orice ar strica un client, de exemplu eliminarea unui câmp sau schimbarea unui tip, apare ca o nouă versiune în cale. Construiește-ți clientul să ignore câmpurile necunoscute și să decidă după codurile de eroare, niciodată după mesaje.
