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

> Crea un link di pagamento e ricevi nella cripto che vuoi, qualunque cosa paghi il tuo cliente e su qualunque chain la detenga.

Ricevi in qualsiasi cripto su qualsiasi chain, con un solo link.

> [!NOTE]
>
> **I link di pagamento sono solo web.** Creali nel Moove Widget su [moove.xyz](https://www.moove.xyz) e seguili nella dashboard: vedi [Link di pagamento Moove](https://docs.moove.xyz/it-it/manage/moove-payment-links.md).
>
> Nella **Moove App**, la scheda **Ricevi** condivide invece il tuo Moove Handle, il tuo Moove Profile e un codice QR. Chiunque può pagarti da lì per qualsiasi importo.

## Come creo un link di pagamento?

**1. Apri la scheda Ricevi**

Nel Moove Widget su [moove.xyz](https://www.moove.xyz).

**2. Inserisci l'importo**

Sotto **Stai ricevendo**, espresso nel tuo [token di regolamento](https://docs.moove.xyz/it-it/concepts/settlement-and-auto-routing.md), cioè il token in cui hai scelto di essere pagato.

**3. Aggiungi una descrizione**

Facoltativa, e mostrata a chi paga nella pagina di checkout. Attiva la **Vista avanzata** sotto l'icona delle impostazioni per mostrare il campo.

**4. Fai clic su Crea link di pagamento**

Copialo e mettilo in una fattura, in un DM, in una bio, in un'email: ovunque.

> [!NOTE]
>
> I link creati nel Moove Widget sono **monouso e non scadono mai**. Si completano appena vengono pagati una volta, quindi un link non può essere riutilizzato né inoltrato.
>
> Per impostare un tetto d'uso diverso o una data di scadenza, crea invece il link tramite l'[API](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md).

## Cosa vede il tuo cliente?

Apre il link, collega un wallet qualsiasi e paga con ciò che ha, sulla chain in cui lo ha.

Non ha bisogno di un account Moove. Non ha bisogno di sapere quale token vuoi. Qualsiasi swap o bridge necessario avviene dentro il suo pagamento, e arriva nel tuo wallet nel tuo token.

## Quali sono le impostazioni del link?

| Impostazione | Cosa fa | Dove puoi impostarla |
| - | - | - |
| **Importo** | Quanto chiedi, nel tuo token di regolamento | Moove Widget e API |
| **Descrizione** | Mostrata a chi paga nella pagina di checkout. Fino a 160 caratteri nel Moove Widget, 500 tramite l'API | Moove Widget e API |
| **Tetto d'uso** | Quanti pagamenti accetta il link prima di completarsi | **Solo API** — il Moove Widget imposta sempre 1 |
| **Scadenza** | Dopo questo momento, il link non accetta più pagamenti | **Solo API** — i link del Moove Widget non scadono mai |

> [!TIP]
>
> Il Moove Widget è pensato per il caso più comune: una fattura, un pagamento. Se ti serve un link che accetti più pagamenti, o uno che scada a una data, è per questo che esiste l'API.

## Quali sono gli stati del link?

| Stato | Significato |
| - | - |
| **Attivo** | Accetta pagamenti |
| **Completato** | Ha raggiunto il tetto d'uso |
| **Inattivo** | Lo hai disattivato tu, oppure è scaduto |

Segui e disattiva i link dalla dashboard web.

[Link di pagamento Moove →](https://docs.moove.xyz/it-it/manage/moove-payment-links.md)

## Come vengo pagato nella Moove App?

La Moove App non ha una schermata per i link di pagamento. La sua scheda **Ricevi** ti offre tre modi per essere pagato, tutti in cui è chi paga a scegliere l'importo:

| Metodo | Come condividerlo |
| - | - |
| **Il tuo Moove Handle** | Tocca per copiare `@yourname` |
| **Il tuo Moove Profile** | Tocca per copiare il tuo link `moove.xyz/@yourname` |
| **Codice QR** | Tocca **Condividi codice QR** per inviarlo o mostrarlo |

Qualunque cosa usino per pagare, ti arriva regolata nel tuo token di regolamento, con lo stesso instradamento di un link di pagamento.

> [!TIP]
>
> Per un importo fisso da mobile, crea il link sul web e condividilo dal telefono. Il link funziona ovunque.

## Link di pagamento o Moove Profile?

| | Link di pagamento | [Moove Profile](https://docs.moove.xyz/it-it/brand/moove-profile.md) |
| - | - | - |
| Chi imposta l'importo | Tu | Chi paga |
| Ideale per | Fatture, checkout, prezzi fissi | Mance, donazioni, link nella bio |
| Riutilizzabile | Fino al tetto d'uso | Sempre |
| Scade | Se imposti una scadenza | Mai |

## Link perpetui e personalizzati

> [!NOTE]
>
> **In arrivo.** I link perpetui (riutilizzabili all'infinito con una propria identità) e i link personalizzati (con il tuo marchio per ogni campagna) sono annunciati ma non ancora realizzati. Tutto ciò che c'è in questa pagina descrive ciò che è disponibile oggi.

## Come lo faccio nel codice?

Lo stesso link di pagamento è una sola chiamata API, ed è così che incassi sul tuo sito.

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

Manda chi paga all'`url` presente nella risposta.

[API dei link di pagamento Moove →](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md) · [Moove Agentic Payments →](https://docs.moove.xyz/it-it/transact/moove-agentic-payments.md)

## Quanto costa Moove Receive?

Un pagamento che non richiede swap né bridge è gratuito. Tutto ciò che è tra token o tra chain diverse comporta una commissione di protocollo, e su un link di pagamento **la paga chi paga**: tu ricevi esattamente l'importo che hai chiesto.

> [!TIP]
>
> È il motivo pratico per cui conviene fatturare con un link di pagamento anziché con il tuo Moove Profile: su un Profile è chi paga a decidere l'importo, quindi la commissione viene tolta da ciò che ti arriva.

Le cifre sono nella pagina [Prezzi](https://docs.moove.xyz/it-it/product-prices/how-product-and-prices-work.md).

## Cosa leggere dopo

> [card] [Link di pagamento Moove](https://docs.moove.xyz/it-it/manage/moove-payment-links.md)
>
> Segui e disattiva.

> [card] [Chiavi API Moove](https://docs.moove.xyz/it-it/manage/moove-api-keys.md)
>
> Crea link nel codice.

> [card] [Moove Profile](https://docs.moove.xyz/it-it/brand/moove-profile.md)
>
> Fatti pagare senza un link.

Un link, qualsiasi cripto, qualsiasi chain. Il tuo denaro. La tua mossa.


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