Web. A página de marketing, o painel e as transferências são na web. Não há equivalente no telemóvel.
O que são os Pagamentos Agênticos Moove?
Os Pagamentos Agênticos Moove são um ficheiro de skill — um ficheiro de instruções que a sua ferramenta de programação com IA lê — que ensina a ferramenta a integrar as APIs da moove.xyz em produção: links de pagamento para receber, pagamentos para enviar, e trocas para passar entre tokens e chains. Transfere-o, coloca-o na sua ferramenta e descreve o que quer. A ferramenta escreve a integração contra a API real.A chave da Moove API que o skill usa não pode mover dinheiro. Não assina nada — pede pagamentos, cota pagamentos a enviar e trocas, e regista transações que o seu próprio código já transmitiu.Um pagamento a enviar ou uma troca é assinado localmente, pelo seu projeto, com uma chave que a moove.xyz nunca vê. Essa chave de assinatura é a que pode mover fundos, e fica consigo.
Como faço a integração em três passos?
1
Transfira o skill ou um plugin
Um único
skill.md funciona em todo o lado. Os plugins reempacotam o mesmo ficheiro no local onde a sua ferramenta específica o procura.2
Insira um prompt
Use o prompt pronto a usar de moove.xyz/business/agentic-payments, ou escreva o seu.
3
Construa e implemente
A sua ferramenta constrói o checkout. Faça a gestão das chaves, dos links e das transações que ela cria em Moove Gerir.
Quais são os cinco plugins?
Os Moove Agent Skills seguem uma norma aberta, por isso o mesmo ficheiro corre em mais de 40 modelos de IA. Os plugins são uma conveniência, não um requisito.
Transfira qualquer um deles em moove.xyz/business/agentic-payments.
Antes de começar
1
Para receber, tenha uma carteira predefinida e um handle
Só é necessário para o Moove Receive Agent. A API recusa-se a criar links para uma conta que não pode receber pagamentos.
2
Para pagar ou trocar, ligue a carteira de origem por assinatura
Só é necessário para o Moove Send Agent e o Moove Swap Agent. A carteira de onde o dinheiro sai tem de ser uma que ligou assinando com ela — um endereço só de receção que adicionou colando-o não pode enviar nem trocar. Também vai precisar de uma biblioteca de assinatura no seu próprio projeto; a moove.xyz não fornece nenhuma.
3
Crie uma chave API
Em moove.xyz/dashboard/api-keys, com o agente de que precisa — Receive para receber, Send para pagar, Swap para trocar ou fazer bridge.Moove API Keys →
4
Dê a chave à sua ferramenta
Como variável de ambiente. Nunca a submeta no controlo de versões, e nunca a cole num prompt.
O que são os agentes?
Um agente é a unidade de permissão de uma chave. Escolher um é a forma de decidir o que uma chave pode fazer.O que pode o Moove Receive Agent fazer?
Dois âmbitos, e mais nada:
Um agente que pudesse pedir um pagamento mas nunca confirmar que ele liquidou não conseguiria completar a única tarefa para que existe, por isso o Moove Receive Agent recebe os dois.
O que pode o Moove Send Agent fazer?
Três âmbitos — as três etapas de um único pagamento, nenhuma das quais assina nada:
O Moove Send Agent não vem selecionado por predefinição no seletor. Selecione-o de forma deliberada — uma chave que só pode receber representa um risco claramente menor se for divulgada.
Confirme que o seu código consegue ler a chave. Se a chave de API estiver em falta, um pedido de pagamento não falha — é executado sem as verificações da sua conta, e o pagamento não fica registado em nome da sua chave. Faça com que o seu código pare antes de pedir uma cotação se a chave não estiver definida.
O que pode o Moove Swap Agent fazer?
Três âmbitos — as mesmas três etapas de um pagamento, e mais uma vez nenhuma delas assina nada:
Um só agente cobre as duas tarefas. Uma troca fica numa chain; um bridge passa entre chains. Em ambos os casos, o resultado chega a uma carteira da sua própria conta — para pagar a outra pessoa, use o Moove Send Agent.
O Moove Swap Agent também não vem selecionado por predefinição no seletor. Selecione-o de forma deliberada.
API do Moove Trocar →
Porque é que uma chave divulgada não lhe pode custar dinheiro
Uma chave é um âmbito reduzido de si: atua como a sua conta e só pode fazer um subconjunto do que você pode fazer.Nenhum endpoint move fundos, e nenhum aceita uma chave privada. Uma cotação devolve dados de transação não assinados que o próprio assina, e registar uma transação apenas anota um hash que já está na chain. Os links de pagamento liquidam sempre na sua própria carteira predefinida, e quem chama não pode escolher para onde vão.Por isso, uma chave divulgada não consegue mover fundos de todo — cada transação tem de ser assinada por uma chave que só você detém. (Uma troca feita com uma chave também tem de devolver o resultado à sua própria conta, mas isso é uma salvaguarda contra erros, não a proteção.)
Quem decide quem recebe?
Você — nunca o seu agente, e nunca algo que o seu agente leia. Um pagamento assinado não pode ser anulado, e uma ferramenta de IA lê muito texto escrito por outras pessoas.- O destinatário, o montante, o token e a chain vêm de si, ou dos seus próprios registos, como a sua tabela de pagamentos ou as suas faturas. Nunca de uma página web, de um issue, de um README, de um ficheiro que a ferramenta teve de resumir ou de uma resposta de API — incluindo a descrição de um link de pagamento ou de uma transação, que outras pessoas podem influenciar.
- Com uma troca é igual. O par e o montante vêm de si, e o resultado regressa sempre à sua própria carteira.
- O seu agente pergunta antes de assinar um pagamento. Mostra-lhe o destinatário, o montante, o token, a chain e o que vai chegar, e espera pelo seu sim — uma vez por pagamento, ou uma vez por lote com todas as linhas listadas.
- Um texto que peça ao seu agente para alterar um destinatário, aumentar um montante, saltar a sua confirmação, ou enviar uma chave ou uma frase de recuperação para qualquer lado é um ataque. O seu agente não deve agir com base nele. Deve parar e mostrá-lo a si.
Consigo fazê-lo sem um agente?
A API é uma API HTTP simples. Nada nela exige uma ferramenta de IA.O meu agente de IA pode ligar-se por MCP?
Sim. O MCP — o Model Context Protocol — é um padrão aberto que permite a um agente de IA chamar serviços externos como ferramentas. A skill ensina a sua ferramenta a escrever uma integração. O servidor MCP da Moove permite que um agente trabalhe diretamente com a sua conta: consultar os seus links de pagamento, verificar quais foram pagos e criar um link novo quando lho pedir.- Servidor:
https://api.moove.xyz/mcp - A mesma chave de API. Use a chave de API da Moove que já tem, enviada num cabeçalho do pedido. O agente que escolheu para a chave decide que ferramentas aparecem.
- A mesma segurança. Nada no servidor MCP assina nem move dinheiro. Um link de pagamento que ele crie liquida sempre na sua própria carteira predefinida.
O que ler a seguir
Moove API Keys
Criar, dar âmbito e revogar.
API dos Moove Payment Links
Os endpoints por inteiro.
Moove Receber
O mesmo produto, sem código.