Moove API
Uma chamada. Pago na íntegra.
Crie um link de pagamento a partir do seu código. Seja qual for o token com que o cliente paga, recebe o montante total no seu.
Da chave ao primeiro pagamento.
Crie uma chave API
No Moove Business, crie uma chave para o Moove Receive Agent. Só é mostrada uma vez, por isso guarde-a logo no seu ambiente.Crie um link de pagamento
Um único POST devolve um URL de checkout. O seu cliente paga lá, com qualquer token, em qualquer blockchain.Saiba quando é pago
Registe um endpoint HTTPS e a Moove envia-lhe um evento assinado assim que um link é pago.
API pequena. 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 blockchain que escolheu.Um contrato sobre o qual construir
Versionada no caminho, apenas aditiva na v1, com um esquema OpenAPI sempre atualizado.Limites claros, erros claros
Limites por chave e por IP, um 429 simples e um único formato de erro com códigos estáveis.A API em si não tem custo.
Sem subscrição nem custo por chamada. Um cliente que paga noutro token ou noutra blockchain suporta os 0,02%, por isso recebe o montante total.- Acesso à API
- Grátis
- Mesmo token, mesma rede
- Grátis
- Entre tokens ou redes
- 0,02%
Moove vs construir tudo sozinho.
| Moove vs construir tudo sozinho. | Moove | Desenvolvimento interno |
|---|---|---|
| Blockchains suportadas | Moove: Mais de 30, a partir de um único endpoint | Desenvolvimento interno: Uma integração por blockchain |
| Conversão para o seu token | Moove: Incluída em cada pagamento | Desenvolvimento interno: O seu próprio encaminhamento de swaps e bridges |
| Saber que um pagamento chegou | Moove: Webhooks assinados e um endpoint de listagem | Desenvolvimento interno: Listeners que tem de manter para cada blockchain |
| Página de checkout | Moove: Um link alojado, pronto a partilhar | Desenvolvimento interno: Desenhada, desenvolvida e alojada por si |
| Se uma chave for exposta | Moove: Só pode pedir pagamentos para si | Desenvolvimento interno: Tudo o que estiver na hot wallet |
Perguntas frequentes.
Como obtenho uma chave API?
Inicie sessão na consola do Moove Business e abra Chaves 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 só é mostrada uma vez, ao ser criada, e nunca mais, por isso guarde-a num gestor de segredos. Não existe nenhum endpoint que crie chaves, por isso uma chave nunca pode emitir outra.
Para onde vai o dinheiro quando um cliente paga?
Para a carteira predefinida do titular da chave, na blockchain e no token de liquidação dessa carteira. Quem faz a chamada não pode indicar outro destino. É por isso que a conta precisa de um Moove handle reservado e de uma carteira predefinida com token de liquidação antes da primeira chamada; se faltar um dos dois, criar um link devolve um 409 a indicar que a conta não está pronta para receber pagamentos.
Existe uma API de pagamentos de saída?
Ainda não. A API recebe pagamentos; não os envia. Para pagar hoje a fornecedores ou prestadores de serviços, use Enviar na consola do Moove Business. Já foi anunciado um Moove Send Agent, que aparecerá na documentação quando for lançado.
Como funcionam os webhooks da Moove?
Registe até cinco endpoints HTTPS na consola. 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 através de um segredo mostrado uma única vez. A entrega é feita pelo menos uma vez, por isso elimine duplicados pelo id do evento. Uma entrega falhada é repetida até seis vezes.
Existem limites de pedidos?
Sim. Os pedidos são limitados por chave API e por IP de origem, consoante o limite que for atingido primeiro, e ultrapassá-lo devolve um 429. Use backoff exponencial com algum jitter em vez de repetir de imediato, porque os pedidos rejeitados também contam. Use webhooks para o estado dos pagamentos em vez de consultar repetidamente um único link, e planeie com base no limite por IP se várias integrações partilharem o mesmo host.
Como é feito o versionamento da API?
No caminho. Hoje existe uma versão pública, a v1. As alterações dentro de uma versão apenas acrescentam: novos endpoints, novos campos opcionais, novos campos de resposta. Tudo o que possa quebrar um cliente, como remover um campo ou alterar um tipo, é lançado como uma nova versão no caminho. Construa o seu cliente para ignorar campos desconhecidos e decidir com base nos códigos de erro, nunca nas mensagens.
