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

> Segui ogni link di pagamento che hai creato, vedi cosa è stato pagato e disattiva quelli che non vuoi più attivi.

Vedi ogni link che hai condiviso, quanto ha incassato, e chiudi quelli con cui hai finito.

> [!NOTE]
>
> **Solo web.** I link di pagamento si creano nel Moove Widget e si gestiscono su [moove.xyz/dashboard/payment-link](https://www.moove.xyz/dashboard/payment-link). La Moove App non ha una schermata per i link di pagamento: la sua schermata **Ricevi** condivide invece il tuo handle e il tuo codice QR.

## Quali sono i tre stati?

| Stato | Significato | Accetta pagamenti |
| - | - | - |
| **Attivo** | In funzione e condiviso | Sì |
| **Completato** | Pagato per intero, o ha raggiunto il limite di utilizzo | No |
| **Inattivo** | L'hai disattivato tu, o è scaduto | No |

Filtra l'elenco per stato per vedere cosa è ancora in giro.

## Cosa mostra ogni link?

La dashboard elenca i tuoi link in un'unica tabella. Queste sono le sue colonne:

| Colonna | Cosa mostra |
| - | - |
| **Creato** | Quando l'hai creato |
| **Link** | L'URL da condividere |
| **Importo** | Quanto stai chiedendo, nel tuo token di regolamento |
| **Stato** | Attivo, Completato o Inattivo |
| **Data di scadenza** | Quando smette di accettare pagamenti, oppure **Mai** |
| **Ricevuto** | Quanto è stato effettivamente pagato |
| **Descrizione** | Ciò che vede chi paga |
| **Azione** | **Visualizza**, **Condividi** e **Disattiva** |

## Come disattivo un link?

**1. Apri Gestisci → Link di pagamento**

Nella dashboard web.

**2. Trova il link**

Filtra su **Attivo** se l'elenco è lungo.

**3. Disattivalo**

Il suo stato diventa **inattivo** e smette subito di accettare pagamenti.

> [!WARNING]
>
> La disattivazione è a senso unico. Un link inattivo non può essere riattivato: creane uno nuovo.
>
> Inoltre non "ritira" l'URL già inviato. Chi ha il link ne conserva l'URL; semplicemente smette di funzionare. Se il link è su una pagina pubblica, toglilo anche da lì.

## Lasciare che un link si chiuda da solo

Un link creato nel Moove Widget accetta **un solo pagamento e non scade mai**. Si completa appena viene pagato per intero, così un link per fattura si sistema da sé.

I link creati tramite l'[API](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md) possono anche impostare due limiti:

* **`maxUsage`**: quanti pagamenti accetta il link prima di completarsi.
* **`expirationDate`**: quando smette di accettare pagamenti. Un link oltre la scadenza diventa **Inattivo**.

> [!TIP]
>
> Per le fatture, un link del Moove Widget fa già il suo lavoro: si può pagare una sola volta. Se ti serve anche una scadenza, crea il link tramite l'API con un `expirationDate`.

## Riconciliare con Moove Transactions

Ogni pagamento fatto tramite un link è legato all'id di quel link. L'id non compare nella tabella Transazioni sul web, quindi lì abbina in base alla descrizione, oppure in base all'id del link tramite l'API.

[Moove Transactions →](https://docs.moove.xyz/it-it/manage/moove-transactions.md)

## Come lo faccio nel codice?

L'API elenca i tuoi link con gli stessi stati e gli stessi campi, compresi i link creati dalla dashboard o da un'altra chiave del tuo account: è quindi l'endpoint con cui riconciliare.

```bash theme={null}
curl -sS "https://api.moove.xyz/v1/payment-link?status=active" \
  -H "X-API-Key: $MOOVE_API_KEY"
```

> [!NOTE]
>
> L'API può creare e leggere i link. Disattivare un link è un'azione della dashboard.

[Moove Payment Links API →](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md)

## Cosa leggere dopo

> [card] [Moove Receive](https://docs.moove.xyz/it-it/transact/moove-receive.md)
>
> Crea il prossimo.

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

> [card] [Moove Transactions](https://docs.moove.xyz/it-it/manage/moove-transactions.md)
>
> Vedi cosa è stato pagato.

Ogni link sotto controllo. Your Money. Your Move.


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