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

> Crea un checkout crypto con un solo prompt: scarica la skill Moove Agent nel tuo strumento di coding con AI e lascia che integri per te l'API live dei link di pagamento.

Accetta pagamenti in crypto sul tuo sito incollando un solo prompt nel tuo strumento di coding con AI.

> [!NOTE]
>
> **Web.** La pagina di presentazione, la dashboard e i download sono sul web. Non esiste un equivalente mobile.

## Cos'è Moove Agentic Payments?

Moove Agentic Payments è un **file skill**, un file di istruzioni che il tuo strumento di coding con AI legge, che gli insegna a integrare le API live di moove.xyz: link di pagamento per essere pagato, payout per inviare e swap per passare tra token e chain.

Lo scarichi, lo inserisci nel tuo strumento e descrivi ciò che vuoi. Lo strumento scrive l'integrazione sull'API vera.

> [!NOTE]
>
> **La chiave API Moove usata dalla skill non può spostare denaro.** Non firma nulla: richiede pagamenti, calcola i prezzi di payout e swap, e registra le transazioni che il tuo codice ha già trasmesso.
>
> Un payout o uno swap viene firmato in locale, dal tuo progetto, con una chiave che moove.xyz non vede mai. È quella chiave di firma a poter spostare fondi, e resta con te.

## Come integro in tre passaggi?

**1. Scarica la skill o un plugin**

Un solo `skill.md` funziona ovunque. I plugin riconfezionano lo stesso file nella posizione in cui lo cerca il tuo strumento specifico.

**2. Inserisci un prompt**

Usa il prompt pronto su [moove.xyz/business/agentic-payments](https://www.moove.xyz/business/agentic-payments), oppure scrivine uno tuo.

**3. Costruisci e pubblica**

Il tuo strumento costruisce il checkout. Gestisci le chiavi, i link e le transazioni che crea in [Moove Manage](https://docs.moove.xyz/it-it/manage/overview.md).

## Quali sono i cinque plugin?

Le Moove Agent Skills seguono uno standard aperto, quindi lo stesso file funziona su più di 40 modelli di AI. I plugin sono una comodità, non un obbligo.

| Strumento | Cosa installa il plugin |
| - | - |
| **Claude Code** | Un manifest del plugin più la skill |
| **Codex** | `AGENTS.md` |
| **Gemini CLI** | `GEMINI.md` |
| **Cursor** | Un file di regole in `.cursor/rules/` |
| **GitHub Copilot** | `.github/copilot-instructions.md` |

Scarica uno qualsiasi di questi da [moove.xyz/business/agentic-payments](https://www.moove.xyz/business/agentic-payments).

> [!TIP]
>
> Non usi nessuno dei cinque? Scarica il semplice `skill.md` e mettilo dove il tuo strumento legge le istruzioni. È lo stesso file.

## Prima di iniziare

**1. Per essere pagato, serve un wallet predefinito e un handle**

Serve solo per il **Moove Receive Agent**. L'API rifiuta di creare link per un account che non può ricevere pagamenti.

**2. Per fare payout o swap, collega il wallet di finanziamento con la firma**

Serve solo per il **Moove Send Agent** e il **Moove Swap Agent**. Il wallet da cui escono i soldi deve essere uno che hai collegato *firmando* con esso: un indirizzo solo per ricevere, aggiunto incollandolo, non può inviare né fare swap. Ti serve anche una libreria di firma nel tuo progetto; moove.xyz non ne fornisce nessuna.

**3. Crea una chiave API**

Su [moove.xyz/dashboard/api-keys](https://www.moove.xyz/dashboard/api-keys), limitata all'agent che ti serve: Receive per incassare pagamenti, Send per fare payout, Swap per fare swap o bridge.

> [!WARNING]
>
> La chiave viene mostrata una sola volta, in chiaro, al momento della creazione. Copiala subito: non potrà essere mostrata di nuovo.

[Moove API Keys →](https://docs.moove.xyz/it-it/manage/moove-api-keys.md)

**4. Dai la chiave al tuo strumento**

Come variabile d'ambiente. Non committarla mai e non incollarla mai in un prompt.

## Cosa sono gli agent?

Un **agent** è l'unità di permesso su una chiave. Sceglierne uno è il modo in cui decidi cosa può fare una chiave.

| Agent | Stato | Cosa fa |
| - | - | - |
| **Moove Receive Agent** | **Attivo** | Crea link di pagamento ospitati monouso e li rilegge |
| **Moove Send Agent** | **Attivo** | Fa payout a qualsiasi Moove Handle o indirizzo di wallet, su qualsiasi chain |
| **Moove Swap Agent** | **Attivo** | Fa swap su una chain, o bridge tra chain, nel tuo wallet |
| Moove Ramp Agent | In arrivo | Passa tra valuta locale e crypto |

> [!WARNING]
>
> **Receive, Send e Swap sono attivi.** Solo il Moove Ramp Agent è ancora annunciato e non realizzato: compare nel selettore disattivato e con l'etichetta in arrivo. Non esiste un agent Bridge: il bridging è ciò che fa il Moove Swap Agent, sullo stesso endpoint di uno swap sulla stessa chain.

## Cosa può fare il Moove Receive Agent?

Due scope, e nient'altro:

| Scope | Concede |
| - | - |
| `payment_link:create` | Creare link di pagamento |
| `payment_link:read` | Elencare i link di pagamento |

Un agent che potesse richiedere un pagamento ma non confermarne il regolamento non potrebbe portare a termine l'unico compito per cui esiste, quindi il Moove Receive Agent li ha entrambi.

## Cosa può fare il Moove Send Agent?

Tre scope, i tre passaggi di un payout, nessuno dei quali firma qualcosa:

| Scope | Concede |
| - | - |
| `send:quote` | Costruire una transazione di invio **non firmata** |
| `send:create` | Registrare un invio che hai già trasmesso |
| `transaction:read` | Leggere le tue transazioni |

> [!WARNING]
>
> **moove.xyz non firma mai, e il tuo agent deve farlo.** Non esiste una chiamata "invia denaro". moove.xyz calcola il prezzo del payout e restituisce una transazione *non firmata*; il tuo codice la firma e la trasmette con una chiave che moove.xyz non vede mai, poi comunica a moove.xyz l'hash.
>
> Quindi il tuo agent ha bisogno di una libreria di firma nel tuo progetto e di un wallet di finanziamento **collegato al tuo account Moove con la firma**. Un indirizzo solo per ricevere, aggiunto incollandolo, non può inviare: il payout viene rifiutato prima che qualcosa venga firmato.

Send **non** è selezionato per impostazione predefinita nel selettore. Selezionalo di proposito: una chiave che può solo ricevere è una cosa molto più piccola da perdere.

> [!NOTE]
>
> **Assicurati che il tuo codice possa leggere la chiave.** Se la chiave API manca, una richiesta di payout non fallisce: viene eseguita senza i controlli del tuo account e il payout non viene registrato sulla tua chiave. Fai in modo che il tuo codice si fermi prima di chiedere un preventivo se la chiave non è impostata.

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

## Cosa può fare il Moove Swap Agent?

Tre scope, gli stessi tre passaggi di un payout, e anche qui nessuno firma qualcosa:

| Scope | Concede |
| - | - |
| `swap:quote` | Costruire una transazione di swap o bridge **non firmata** |
| `swap:create` | Registrare uno swap o un bridge che hai già trasmesso |
| `transaction:read` | Leggere le tue transazioni |

Un solo agent copre entrambi i compiti. Uno swap resta su una chain; un bridge si sposta tra chain. In ogni caso l'output arriva in un wallet del tuo account: per pagare qualcun altro, usa il Moove Send Agent.

> [!WARNING]
>
> **È il tuo agent a firmare lo swap, non moove.xyz.** Ha bisogno delle stesse due cose di un payout: una libreria di firma nel tuo progetto e un wallet di finanziamento **collegato al tuo account Moove con la firma**. Un wallet non collegato viene rifiutato quando il tuo agent chiede un preventivo, prima che qualcosa venga firmato.

Anche Swap **non** è selezionato per impostazione predefinita nel selettore. Selezionalo di proposito.

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

## Perché una chiave trapelata non può costarti denaro

> [!NOTE]
>
> Una chiave è un **sottoinsieme di te**: agisce come il tuo account e può fare solo una parte di ciò che puoi fare tu.
>
> Nessun endpoint sposta fondi e nessuno accetta una chiave privata. Un preventivo restituisce dati di transazione **non firmati** che firmi tu, e registrare una transazione scrive solo un hash già presente on-chain. I link di pagamento vengono sempre regolati sul tuo wallet predefinito, e chi chiama non può scegliere dove vanno.
>
> Quindi una chiave trapelata non può spostare fondi: ogni transazione deve essere firmata da una chiave che hai solo tu. (Uno swap con chiave deve anche restituire il suo output al tuo account, ma è una protezione contro gli errori, non la difesa vera.)

> [!WARNING]
>
> Questo non significa innocua. Una chiave trapelata può leggere la cronologia delle tue transazioni, creare link di pagamento che pagano *te* e registrare transazioni sui tuoi wallet. Revocala: semplicemente non può prendere i soldi.

Revoca una chiave di cui non ti fidi più. La revoca è permanente e immediata.

## Chi decide chi viene pagato?

Tu, mai il tuo agent e mai qualcosa che il tuo agent legge. Un payout firmato non si può annullare, e uno strumento di AI legge molto testo scritto da altri.

* **Il destinatario, l'importo, il token e la chain vengono da te**, o dai tuoi registri, come la tabella dei payout o le tue fatture. Mai da una pagina web, una issue, un README, un file che allo strumento è stato chiesto di riassumere o una risposta API, compresa la descrizione di un link di pagamento o di una transazione, che altri possono influenzare.
* **Uno swap è uguale.** La coppia e l'importo vengono da te, e l'output torna sempre al tuo wallet.
* **Il tuo agent chiede prima di firmare un payout.** Ti mostra il destinatario, l'importo, il token, la chain e ciò che arriverà, e aspetta il tuo sì: una volta per payout, o una volta per lotto con ogni riga elencata.
* **Il testo che chiede al tuo agent di cambiare un destinatario, aumentare un importo, saltare la tua conferma o inviare una chiave o una frase seed da qualche parte è un attacco.** Il tuo agent non deve dargli seguito. Deve fermarsi e mostrartelo.

## Posso farlo senza un agent?

L'API è una semplice API HTTP. Niente richiede uno strumento di AI.

```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 }'
```

[Riferimento API →](https://docs.moove.xyz/api-reference/introduction.md)

## Il mio agent AI può connettersi con MCP?

Sì. **MCP**, il Model Context Protocol, è uno standard aperto che permette a un agent AI di chiamare servizi esterni come strumenti. La skill insegna al tuo strumento a scrivere un'integrazione. Il server Moove MCP permette a un agent di lavorare direttamente con il tuo account: cercare i tuoi link di pagamento, controllare quali sono stati pagati e creare un nuovo link quando glielo chiedi.

* **Server:** `https://api.moove.xyz/mcp`
* **Stessa chiave API.** Usa la chiave API Moove che hai già, inviata come intestazione della richiesta. L'agent scelto per la chiave decide quali strumenti compaiono.
* **Stessa sicurezza.** Niente sul server MCP firma o sposta denaro. Un link di pagamento che crea viene sempre regolato sul tuo wallet predefinito.

Connettiti oggi da Claude Code, Cursor, Codex, GitHub Copilot o Gemini CLI. La connessione da claude.ai e ChatGPT arriverà più avanti.

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

## Cosa leggere dopo

> [card] [Moove API Keys](https://docs.moove.xyz/it-it/manage/moove-api-keys.md)
>
> Crea, limita e revoca.

> [card] [Moove Payment Links API](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md)
>
> Gli endpoint al completo.

> [card] [Moove Receive](https://docs.moove.xyz/it-it/transact/moove-receive.md)
>
> Lo stesso prodotto, senza codice.

Clicca. Integra. Transigi. I tuoi soldi. Le tue mosse.


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