> ## 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.

# Pagamentos Agênticos Moove

> Construa um checkout em cripto com um único prompt — transfira o Moove Agent skill para a sua ferramenta de programação com IA e deixe-a integrar por si a API de links de pagamento em produção.

Aceite pagamentos em cripto no seu próprio site — colando um único prompt na sua ferramenta de programação com IA.

<Info>
  **Web.** A página de marketing, o painel e as transferências são na web. Não há equivalente no telemóvel.
</Info>

## 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 a API de links de pagamento da moove.xyz em produção.

Transfere-o, coloca-o na sua ferramenta e descreve o que quer. A ferramenta escreve a integração contra a API real.

<Note>
  O skill nunca move dinheiro. Lê documentação e escreve código. Todos os pagamentos continuam a liquidar on-chain na carteira da conta a que a chave API pertence, e a própria chave não consegue redirecionar fundos para mais lado nenhum.
</Note>

## Como faço a integração em três passos?

<Steps>
  <Step title="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.
  </Step>

  <Step title="Insira um prompt">
    Use o prompt pronto a usar de [moove.xyz/agentic-payments](https://www.moove.xyz/agentic-payments), ou escreva o seu.
  </Step>

  <Step title="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](/pt-pt/manage/overview).
  </Step>
</Steps>

## 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.

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

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

<Tip>
  Não usa nenhuma das cinco? Transfira o `skill.md` simples e coloque-o onde a sua ferramenta lê instruções. É o mesmo ficheiro.
</Tip>

## Antes de começar

<Steps>
  <Step title="Tenha uma conta Moove com uma carteira predefinida e um identificador">
    A API recusa-se a criar links para uma conta que não pode receber pagamentos.
  </Step>

  <Step title="Crie uma chave API">
    Em [moove.xyz/dashboard/api-keys](https://www.moove.xyz/dashboard/api-keys), com âmbito no **Moove Receive Agent**.

    <Warning>
      A chave é mostrada uma vez, em texto simples, no momento da criação. Copie-a nessa altura — não pode voltar a ser mostrada.
    </Warning>

    [Moove API Keys →](/pt-pt/manage/moove-api-keys)
  </Step>

  <Step title="Dê a chave à sua ferramenta">
    Como variável de ambiente. Nunca a submeta no controlo de versões, e nunca a cole num prompt.
  </Step>
</Steps>

## 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.

| Agente                  | Estado    | O que faz                                                             |
| ----------------------- | --------- | --------------------------------------------------------------------- |
| **Moove Receive Agent** | **Ativo** | Cria links de pagamento alojados de utilização única e volta a lê-los |
| Moove Send Agent        | Em breve  | Pagar a qualquer identificador, endereço ou alias                     |
| Moove Swap Agent        | Em breve  | Trocar e fazer ponte com o encaminhamento tratado                     |
| Moove Ramp Agent        | Em breve  | Passar entre moeda local e cripto                                     |

<Warning>
  **Só existe o Moove Receive Agent.** Os outros três estão anunciados, não construídos — aparecem no seletor desativados e marcados como em breve. Hoje uma chave só pode conter âmbitos do Moove Receber.
</Warning>

## O que pode o Moove Receive Agent fazer?

Dois âmbitos, e mais nada:

| Âmbito                | Concede                   |
| --------------------- | ------------------------- |
| `payment_link:create` | Criar links de pagamento  |
| `payment_link:read`   | Listar links de pagamento |

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.

## Porque é que uma chave divulgada não lhe pode custar dinheiro

<Note>
  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. Os links de pagamento liquidam sempre na carteira predefinida de quem detém a chave, e quem chama não pode indicar um destino. Uma chave divulgada pode criar pedidos de pagamento que *lhe* pagam a si — não pode redirecionar dinheiro para mais ninguém.
</Note>

Revogue uma chave em que já não confie. A revogação é definitiva e imediata.

## Consigo fazê-lo sem um agente?

A API é uma API HTTP simples. 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 →](/api-reference/introduction)

## O que ler a seguir

<CardGroup cols={3}>
  <Card title="Moove API Keys" icon="key" href="/pt-pt/manage/moove-api-keys">
    Criar, dar âmbito e revogar.
  </Card>

  <Card title="API dos Moove Payment Links" icon="link" href="/api-reference/moove-receive/moove-payment-links">
    Os endpoints por inteiro.
  </Card>

  <Card title="Moove Receber" icon="hand-coins" href="/pt-pt/transact/moove-receive">
    O mesmo produto, sem código.
  </Card>
</CardGroup>

Clique. Integre. Transacione. O seu dinheiro. O seu movimento.