> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moove.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Moove Agentic Payments

> Crie um checkout cripto com um único prompt: baixe a skill do Moove Agent na sua ferramenta de IA para programar e deixe que ela integre a API de links de pagamento ativa para você.

Receba pagamentos em cripto no seu próprio site colando um único prompt na sua ferramenta de IA para programar.

> [!NOTE]
>
> **Web.** A página de divulgação, o painel e os downloads são web. Não há equivalente no celular.

## O que é o Moove Agentic Payments?

O Moove Agentic Payments é um **arquivo de skill**, um arquivo de instruções que sua ferramenta de IA para programar lê, que ensina a ferramenta a integrar as APIs ativas da moove.xyz: links de pagamento para receber, pagamentos de saída (payouts) para enviar e swaps para trocar entre tokens e redes.

Você baixa, coloca na sua ferramenta e descreve o que quer. A ferramenta escreve a integração usando a API real.

> [!NOTE]
>
> **A chave de API Moove que a skill usa não consegue movimentar dinheiro.** Ela não assina nada: solicita pagamentos, cota payouts e swaps e registra transações que o seu próprio código já transmitiu.
>
> Um payout ou um swap é assinado localmente, pelo seu projeto, com uma chave que a moove.xyz nunca vê. Essa chave de assinatura é a que pode movimentar fundos, e ela fica com você.

## Como integro em três passos?

**1. Baixe a skill ou um plugin**

Um único `skill.md` funciona em qualquer lugar. Os plugins reempacotam o mesmo arquivo no local em que a sua ferramenta específica o procura.

**2. Insira um prompt**

Use o prompt pronto de [moove.xyz/business/agentic-payments](https://www.moove.xyz/business/agentic-payments) ou escreva o seu.

**3. Construa e publique**

Sua ferramenta constrói o checkout. Gerencie as chaves, os links e as transações que ela cria no [Moove Manage](https://docs.moove.xyz/pt-br/manage/overview.md).

## Quais são os cinco plugins?

As Moove Agent Skills seguem um padrão aberto, então o mesmo arquivo funciona em mais de 40 modelos de IA. Os plugins são uma conveniência, não uma exigência.

| Ferramenta | O que o plugin instala |
| - | - |
| **Claude Code** | Um manifesto de plugin mais a skill |
| **Codex** | `AGENTS.md` |
| **Gemini CLI** | `GEMINI.md` |
| **Cursor** | Um arquivo de regras em `.cursor/rules/` |
| **GitHub Copilot** | `.github/copilot-instructions.md` |

Baixe qualquer um deles em [moove.xyz/business/agentic-payments](https://www.moove.xyz/business/agentic-payments).

> [!TIP]
>
> Não usa nenhuma das cinco? Baixe o `skill.md` simples e coloque onde a sua ferramenta lê instruções. É o mesmo arquivo.

## Antes de começar

**1. Para receber, tenha uma carteira padrão e um handle**

Necessário apenas para o **Moove Receive Agent**. A API se recusa a criar links para uma conta que não pode receber pagamentos.

**2. Para fazer payouts ou swaps, conecte a carteira de origem por assinatura**

Necessário apenas para o **Moove Send Agent** e o **Moove Swap Agent**. A carteira de onde o dinheiro sai precisa ser uma que você conectou *assinando* com ela: um endereço somente de recebimento que você adicionou colando não pode enviar nem fazer swap. Você 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 de API**

Em [moove.xyz/dashboard/api-keys](https://www.moove.xyz/dashboard/api-keys), com escopo para o agente de que você precisa: Receive para receber pagamentos, Send para fazer payouts, Swap para trocar ou fazer bridge.

> [!WARNING]
>
> A chave é exibida uma única vez, em texto simples, na criação. Copie-a nesse momento: ela não pode ser exibida de novo.

[Chaves de API Moove →](https://docs.moove.xyz/pt-br/manage/moove-api-keys.md)

**4. Passe a chave para a sua ferramenta**

Como variável de ambiente. Nunca faça commit dela e nunca a cole em um prompt.

## Quais são os agentes?

Um **agente** é a unidade de permissão de uma chave. Escolher um é como você decide o que uma chave pode fazer.

| Agente | Status | O que faz |
| - | - | - |
| **Moove Receive Agent** | **No ar** | Cria links de pagamento hospedados de uso único e os consulta depois |
| **Moove Send Agent** | **No ar** | Faz payouts para qualquer Moove Handle ou endereço de carteira, em qualquer rede |
| **Moove Swap Agent** | **No ar** | Faz swap em uma rede, ou bridge entre redes, para a sua própria carteira |
| Moove Ramp Agent | Em breve | Passa de moeda local para cripto e vice-versa |

> [!WARNING]
>
> **Receive, Send e Swap estão no ar.** Só o Moove Ramp Agent ainda está anunciado e não construído: ele aparece desativado no seletor, com o rótulo "em breve". Não existe um agente de Bridge: fazer bridge é o que o Moove Swap Agent faz, no mesmo endpoint de um swap na mesma rede.

## O que o Moove Receive Agent pode fazer?

Dois escopos, e nada além:

| Escopo | Permite |
| - | - |
| `payment_link:create` | Criar links de pagamento |
| `payment_link:read` | Listar links de pagamento |

Um agente que pudesse solicitar um pagamento, mas nunca confirmar que foi liquidado, não conseguiria cumprir a única tarefa para a qual existe, então o Moove Receive Agent recebe os dois.

## O que o Moove Send Agent pode fazer?

Três escopos, as três etapas de um payout, e nenhuma delas assina nada:

| Escopo | Permite |
| - | - |
| `send:quote` | Montar uma transação de envio **não assinada** |
| `send:create` | Registrar um envio que você já transmitiu |
| `transaction:read` | Ler as suas próprias transações |

> [!WARNING]
>
> **A moove.xyz nunca assina, e o seu agente precisa assinar.** Não existe uma chamada "enviar dinheiro". A moove.xyz cota o payout e devolve uma transação *não assinada*; o seu próprio código a assina e a transmite com uma chave que a moove.xyz nunca vê, e depois informa o hash à moove.xyz.
>
> Por isso, o seu agente precisa de uma biblioteca de assinatura no seu projeto e de uma carteira de origem **conectada à sua conta Moove por assinatura**. Um endereço somente de recebimento que você adicionou colando não pode enviar: o payout é recusado antes de qualquer coisa ser assinada.

O Send **não** vem marcado por padrão no seletor. Marque-o de propósito: uma chave que só recebe é muito menos perigosa se vazar.

> [!NOTE]
>
> **Garanta que o seu código consiga ler a chave.** Se a chave de API estiver ausente, a solicitação de payout não falha: ela roda sem as verificações da sua conta, e o payout não é registrado na sua chave. Faça o seu código parar antes de pedir uma cotação se a chave não estiver definida.

[API do Moove Send →](https://docs.moove.xyz/api-reference/moove-send.md)

## O que o Moove Swap Agent pode fazer?

Três escopos, as mesmas três etapas de um payout, e de novo nenhuma delas assina nada:

| Escopo | Permite |
| - | - |
| `swap:quote` | Montar uma transação de swap ou bridge **não assinada** |
| `swap:create` | Registrar um swap ou bridge que você já transmitiu |
| `transaction:read` | Ler as suas próprias transações |

Um agente cobre as duas tarefas. O swap fica em uma rede; a bridge atravessa redes. Em ambos os casos, o resultado cai em uma carteira da sua própria conta; para pagar outra pessoa, use o Moove Send Agent.

> [!WARNING]
>
> **Quem assina o swap é o seu agente, não a moove.xyz.** Ele precisa das mesmas duas coisas de um payout: uma biblioteca de assinatura no seu projeto e uma carteira de origem **conectada à sua conta Moove por assinatura**. Uma carteira que não esteja conectada é recusada quando o seu agente pede uma cotação, antes de qualquer coisa ser assinada.

O Swap também **não** vem marcado por padrão no seletor. Marque-o de propósito.

[API do Moove Swap →](https://docs.moove.xyz/api-reference/moove-swap.md)

## Por que uma chave vazada não pode custar dinheiro a você

> [!NOTE]
>
> Uma chave é uma **versão restrita de você**: ela age como a sua conta e só pode fazer um subconjunto do que você pode fazer.
>
> Nenhum endpoint movimenta fundos, e nenhum aceita uma chave privada. Uma cotação devolve dados de transação **não assinados** que você mesmo assina, e registrar uma transação só anota um hash que já está na blockchain. Os links de pagamento sempre são liquidados na sua própria carteira padrão, e quem chama não pode escolher para onde vão.
>
> Portanto, uma chave vazada não consegue movimentar fundos de forma alguma: toda transação precisa ser assinada por uma chave que só você tem. (Um swap feito com chave também precisa devolver o resultado à sua própria conta, mas isso é uma proteção contra erros, não a proteção principal.)

> [!WARNING]
>
> Isso não quer dizer inofensiva. Uma chave vazada pode ler o seu histórico de transações, criar links de pagamento que pagam a *você* e registrar transações nas suas próprias carteiras. Revogue-a: ela simplesmente não consegue levar o dinheiro.

Revogue uma chave em que você não confia mais. A revogação é permanente e imediata.

## Quem decide quem recebe?

Você, nunca o seu agente e nunca algo que o seu agente leia. Um payout assinado não pode ser desfeito, e uma ferramenta de IA lê muito texto escrito por outras pessoas.

* **O destinatário, o valor, o token e a rede vêm de você**, ou dos seus próprios registros, como a sua tabela de payouts ou as suas faturas. Nunca de uma página web, uma issue, um README, um arquivo que a ferramenta foi pedida para resumir ou uma resposta de API, incluindo a descrição de um link de pagamento ou de uma transação, que outras pessoas podem influenciar.
* **Um swap é igual.** O par e o valor vêm de você, e o resultado sempre volta para a sua própria carteira.
* **Seu agente pergunta antes de assinar um payout.** Ele mostra o destinatário, o valor, o token, a rede e o que vai chegar, e espera o seu sim: uma vez por payout, ou uma vez por lote com todas as linhas listadas.
* **Um texto que peça ao seu agente para trocar um destinatário, aumentar um valor, pular a sua confirmação ou enviar uma chave ou frase secreta para algum lugar é um ataque.** O seu agente não deve agir com base nele. Deve parar e mostrá-lo a você.

## Posso fazer sem um agente?

A API é uma API HTTP comum. Nada nela exige uma ferramenta de IA.

```bash theme={null}
curl -sS -X POST "https://api.moove.xyz/v1/payment-link" \
  -H "X-API-Key: $MOOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "toAmount": "49.99", "description": "INV-2026-0142", "maxUsage": 1 }'
```

[Referência da API →](https://docs.moove.xyz/api-reference/introduction.md)

## Meu agente de IA pode se conectar por MCP?

Sim. **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 Moove MCP permite que um agente trabalhe diretamente com a sua conta: consulte os seus links de pagamento, veja quais foram pagos e crie um novo link quando você pedir.

* **Servidor:** `https://api.moove.xyz/mcp`
* **A mesma chave de API.** Use a chave de API Moove que você já tem, enviada como cabeçalho da requisição. O agente que você escolheu para a chave define quais ferramentas aparecem.
* **A mesma segurança.** Nada no servidor MCP assina ou movimenta dinheiro. Um link de pagamento que ele cria sempre é liquidado na sua própria carteira padrão.

Conecte pelo Claude Code, Cursor, Codex, GitHub Copilot ou Gemini CLI hoje. A conexão pelo claude.ai e pelo ChatGPT vem depois.

[Servidor MCP →](https://docs.moove.xyz/api-reference/mcp.md)

## O que ler a seguir

> [card] [Chaves de API Moove](https://docs.moove.xyz/pt-br/manage/moove-api-keys.md)
>
> Crie, defina escopos e revogue.

> [card] [API de links de pagamento Moove](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md)
>
> Os endpoints completos.

> [card] [Moove Receive](https://docs.moove.xyz/pt-br/transact/moove-receive.md)
>
> O mesmo produto, sem código.

Clique. Integre. Transacione. Seu dinheiro. Sua jogada.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.