Moove API
Uma chamada. Pago por inteiro.
Crie um link de pagamento pelo seu código. Seu cliente paga com qualquer token e você recebe o valor integral no seu.
Da chave ao primeiro pagamento.
Crie uma chave de API
No Moove Business, crie uma chave para o Moove Receive Agent. Ela é mostrada uma única vez, então coloque-a direto no seu ambiente.Crie um link de pagamento
Um POST retorna uma URL de checkout. Seu cliente paga ali, com qualquer token, em qualquer rede.Saiba quando foi pago
Cadastre um endpoint HTTPS e a Moove envia um evento assinado no instante em que um link for pago.
API enxuta. Garantias sólidas.
Qualquer token entra, o seu sai
Os clientes pagam com o que têm, em mais de 30 redes blockchain. Cada pagamento é liquidado na sua carteira, no token e na rede que você escolheu.Um contrato em que você pode confiar
Versionada no caminho, aditiva na v1, com um esquema OpenAPI ao vivo.Limites claros, erros claros
Limites por chave e por IP, um 429 direto e um único formato de erro com códigos estáveis.Sem cobrança pela API em si.
Sem assinatura e sem cobrança por chamada. Quem paga com outro token ou em outra rede cobre os 0,02%, e você recebe o valor integral.- Acesso à API
- Grátis
- Mesmo token, mesma rede
- Grátis
- Entre tokens ou redes
- 0,02%
Moove vs. fazer tudo você mesmo.
| Moove vs. fazer tudo você mesmo. | Moove | Desenvolver internamente |
|---|---|---|
| Redes cobertas | MooveMais de 30, num só endpoint | Desenvolver internamenteUma integração por rede |
| Converter para o seu token | MooveEmbutido em todo pagamento | Desenvolver internamenteSua própria rota de swap e bridge |
| Saber que um pagamento chegou | MooveWebhooks assinados e um endpoint de listagem | Desenvolver internamenteListeners que você mantém para cada rede |
| Página de checkout | MooveUm link hospedado, pronto para compartilhar | Desenvolver internamenteProjetada, desenvolvida e hospedada por você |
| Se uma chave vazar | MooveEla não consegue mover seus fundos sozinha | Desenvolver internamenteO que a hot wallet tiver |
Perguntas frequentes.
Como consigo uma chave de API?
Entre no console do Moove Business e abra Chaves de API. Dê um nome à chave e escolha o Moove Receive Agent, que concede permissão para criar e consultar links de pagamento. A chave completa é mostrada uma única vez, na criação, e nunca mais, então guarde-a em um gerenciador de segredos. Não existe endpoint que crie chaves, então uma chave nunca pode emitir outra.
Para onde vai o dinheiro quando um cliente paga?
Para a carteira padrão do dono da chave, na rede e no token de liquidação dessa carteira. Quem faz a chamada não pode indicar outro destino. Por isso a conta precisa ter um handle Moove reivindicado e uma carteira padrão com token de liquidação antes da primeira chamada; sem os dois, criar um link retorna um 409 dizendo que a conta ainda não está pronta para receber pagamentos.
Existe uma API de pagamentos enviados?
Sim, o Moove Send Agent. Adicione-o a uma chave e a API prepara um pagamento para qualquer @moovehandle ou endereço de carteira, em qualquer rede, como uma transação não assinada. Seu agente assina e transmite com a sua própria chave e depois registra pela API. A Moove nunca guarda sua chave de assinatura, então uma chave de API vazada não consegue mover seus fundos sozinha. O Moove Swap Agent faz o mesmo para swaps e bridges.
Como funcionam os webhooks da Moove?
Cadastre até cinco endpoints HTTPS no console. Cada um recebe dois eventos, um quando um pagamento de um link é liquidado e outro quando um link é concluído. As entregas são assinadas com HMAC-SHA256 usando um segredo mostrado uma única vez. A entrega é pelo menos uma vez, então remova duplicatas pelo id do evento. Uma entrega que falha é tentada de novo até seis vezes.
Existem limites de requisições?
Sim. As requisições são limitadas por chave de API e por IP de origem, valendo o que for atingido primeiro, e passar do limite retorna 429. Espere de forma exponencial, com um pouco de jitter, em vez de tentar de novo na hora, porque requisições rejeitadas também contam. Use webhooks para saber o status do pagamento em vez de consultar um link o tempo todo, e planeje-se pelo limite de IP se várias integrações compartilham o mesmo host.
Como a API é versionada?
No caminho. Hoje há uma versão pública, a v1. As mudanças dentro de uma versão só acrescentam novos endpoints, novos campos opcionais e novos campos de resposta. Tudo o que quebraria um cliente, como remover um campo ou mudar um tipo, sai como uma nova versão no caminho. Faça seu cliente ignorar campos desconhecidos e se basear nos códigos de erro, nunca nas mensagens.
