Moove API
Una chiamata. Pagato per intero.
Crea un link di pagamento dal tuo codice. Il tuo cliente paga con qualsiasi token e tu ricevi l’importo intero nel tuo.
Dalla chiave al primo pagamento.
Crea una chiave API
In Moove Business, crea una chiave per il Moove Receive Agent. Viene mostrata una sola volta, quindi inseriscila subito nel tuo ambiente.Crea un link di pagamento
Una sola POST restituisce un URL di checkout. Il tuo cliente paga lì, con qualsiasi token, su qualsiasi chain.Scopri quando è pagato
Registra un endpoint HTTPS e Moove gli invia un evento firmato nel momento in cui un link viene pagato.
API piccola. Garanzie solide.
Qualsiasi token in entrata, il tuo in uscita
I clienti pagano con ciò che hanno, su oltre 30 reti blockchain. Ogni pagamento si regola nel tuo wallet, nel token e sulla chain che hai scelto.Un contratto su cui puoi costruire
Versionata nel percorso, additiva in v1, con uno schema OpenAPI aggiornato.Limiti chiari, errori chiari
Limiti per chiave e per IP, un semplice 429 e un’unica forma di errore con codici stabili.Nessun costo per l’API in sé.
Nessun abbonamento e nessun costo per chiamata. Un cliente che paga con un altro token o su un’altra rete copre lo 0,02%, così tu ricevi l’importo intero.- Accesso all’API
- Gratis
- Stesso token, stessa rete
- Gratis
- Tra token o reti diversi
- 0,02%
Moove contro farlo da te.
| Moove contro farlo da te. | Moove | Sviluppo interno |
|---|---|---|
| Chain coperte | MooveOltre 30, da un solo endpoint | Sviluppo internoUn’integrazione per ogni chain |
| Conversione nel tuo token | MooveIntegrata in ogni pagamento | Sviluppo internoIl tuo routing di swap e bridge |
| Sapere che un pagamento è arrivato | MooveWebhook firmati e un endpoint di elenco | Sviluppo internoListener da gestire per ogni chain |
| Pagina di checkout | MooveUn link ospitato, pronto da condividere | Sviluppo internoProgettata, sviluppata e ospitata da te |
| Se una chiave viene compromessa | MooveNon può spostare i tuoi fondi da sola | Sviluppo internoTutto ciò che contiene l’hot wallet |
Domande frequenti.
Come ottengo una chiave API?
Accedi alla console di Moove Business e apri Chiavi API. Dai un nome alla chiave e scegli il Moove Receive Agent, che concede il permesso di creare e leggere link di pagamento. La chiave completa viene mostrata una sola volta, alla creazione, e mai più, quindi conservala in un gestore di segreti. Non esiste un endpoint che crei chiavi, quindi una chiave non può mai emetterne un’altra.
Dove va il denaro quando un cliente paga?
Al wallet predefinito del proprietario della chiave, nella chain e nel token di regolamento di quel wallet. Chi chiama non può indicare un’altra destinazione. Per questo l’account ha bisogno di un handle Moove rivendicato e di un wallet predefinito con un token di regolamento prima della prima chiamata; senza entrambi, la creazione di un link restituisce un 409 che segnala che l’account non è pronto a ricevere pagamenti.
Esiste un’API per i pagamenti in uscita?
Sì, il Moove Send Agent. Aggiungilo a una chiave e l’API prepara un pagamento verso qualsiasi @moovehandle o indirizzo di wallet, su qualsiasi chain, come transazione non firmata. Il tuo agente la firma e la trasmette con la tua chiave, poi la registra tramite l’API. Moove non detiene mai la tua chiave di firma, quindi una chiave API compromessa non può spostare i tuoi fondi da sola. Il Moove Swap Agent fa lo stesso per swap e bridge.
Come funzionano i webhook di Moove?
Registra fino a cinque endpoint HTTPS nella console. Ognuno riceve due eventi, uno quando si regola un pagamento su un link e uno quando un link si completa. Le consegne sono firmate con HMAC-SHA256 usando un segreto mostrato una sola volta. La consegna avviene almeno una volta, quindi rimuovi i duplicati usando l’id dell’evento. Una consegna non riuscita viene ritentata fino a sei volte.
Ci sono limiti di frequenza?
Sì. Le richieste sono limitate per chiave API e per IP di origine, a seconda di quale limite viene raggiunto per primo, e superarlo restituisce 429. Rallenta in modo esponenziale con un po' di jitter invece di riprovare subito, perché anche le richieste respinte vengono contate. Usa i webhook per lo stato dei pagamenti invece di interrogare di continuo un singolo link, e pianifica in base al limite per IP se più integrazioni condividono lo stesso host.
Come viene gestito il versionamento dell’API?
Nel percorso. Oggi esiste una sola versione pubblica, v1. Le modifiche dentro una versione si limitano ad aggiungere nuovi endpoint, nuovi campi opzionali e nuovi campi di risposta. Tutto ciò che romperebbe un client, come rimuovere un campo o cambiare un tipo, esce come nuova versione nel percorso. Sviluppa il tuo client in modo che ignori i campi sconosciuti e si basi sui codici di errore, mai sui messaggi.
