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

# Riferimento dei payment link

> Riferimento dei payment link storekit: tipi, modalità di prezzo, stati, campi di creazione, modalità dei campi cliente, ID, strumenti MCP ed eventi webhook.

Consultazione rapida per i termini usati nelle guide dei payment link. Per il dettaglio pratico segui i link in ciascuna sezione.

## Tipi di link

| Etichetta dashboard | Comportamento | Valore API |
| - | - | - |
| **One-off** | Si chiude dopo un pagamento riuscito | `one_off` |
| **Reusable** | Rimane aperto finché non viene disattivato, non scade o non viene raggiunto il limite di pagamenti | `reusable` |

Fissato alla creazione.

## Modalità di prezzo

| Etichetta dashboard | Comportamento | Valore API |
| - | - | - |
| **Set price** | Il cliente paga il **Price** che inserisci | `fixed` |
| **Customer chooses** | Il cliente inserisce un importo, opzionalmente entro **Minimum** e **Maximum** | `variable` |

Fissata alla creazione. **Minimum** e **Maximum** possono essere modificati in seguito.

## Stati del link

| Status | Come ci si arriva | Può essere cambiato? |
| - | - | - |
| **Active** | Creato o riattivato con **Activate** | **Deactivate** |
| **Inactive** | **Deactivate** | **Activate** |
| **Expired** | **Link expiry date** passata | No: crea un nuovo link |
| **Completed** | Link one-off pagato, o link riutilizzabile che ha raggiunto **Maximum number of payments** | No: crea un nuovo link |

Dettagli in [Gestire i payment link](/docs/it/payment-links/managing-payment-links#stati).

## Stati delle transazioni

| Status | Significato | Rimborsabile? |
| - | - | - |
| **Pending** | Pagamento avviato, non ancora confermato | No |
| **Paid** | Pagamento riuscito | Sì |
| **Partial Refund** | Parte del pagamento rimborsata | Sì, fino a **Max refundable** |
| **Refunded** | Interamente rimborsato | No |

Dettagli in [Rimborsi e transazioni](/docs/it/payment-links/refunds-and-transactions).

## Campi di creazione

Etichette come mostrate nella pagina **New Payment Link**. La pagina di dettaglio usa etichette più brevi per gli stessi campi, indicate tra parentesi dove differiscono.

| Campo | Obbligatorio | Modificabile in seguito |
| - | - | - |
| **Store** | Sì | No |
| **Title** | Sì | Sì |
| **Description shown to the customer** (**Description**) | No | Sì |
| **Link type** (**Link Type**) | Sì | No |
| **Pricing** (**Amount Type**) | Sì | No |
| **Price** | Con **Set price** | No |
| **Minimum** / **Maximum** (**Min Amount** / **Max Amount**) | No | Sì |
| **Image** | No | Sì |
| **Customer fields** — **Name**, **Email**, **Phone**, **Business name** | No | Sì |
| **Reference** | No | Sì |
| **Link expiry date** (**Expiry Date**) | No | Sì |
| **Maximum number of payments** (**Max Payments**) | No, solo riutilizzabili | Sì |
| **After successful payment** (**After Payment**) | Sì, default **Show thank you** | Sì |
| **Custom thank you message** (**Success Message**) | No | Sì |
| **Redirect URL after payment** (**Redirect URL**) | Con **Redirect to URL** | Sì |

### Modalità dei campi cliente

| Etichetta dashboard | Comportamento sulla pagina di checkout | Valore API |
| - | - | - |
| **Off** | Campo non mostrato | `disabled` |
| **Optional** | Mostrato, contrassegnato *optional* | `optional` |
| **Required** | Mostrato, deve essere compilato per pagare | `required` |

I quattro campi mappano su `collectCustomerName`, `collectEmail`, `collectPhone` e `collectBusinessName`.

## Da dove arrivano i link

La pagina di dettaglio mostra **Created via** per ogni link:

| Valore | Creato da |
| - | - |
| `dashboard` | **Payment Links** → **Create Payment Link** |
| `order` | Il pulsante **Send Payment Link** su un ordine, consulta [Riscuotere il pagamento di un ordine non pagato](/docs/it/payment-links/collecting-for-an-order) |
| `mcp` | Un assistente AI collegato tramite storekit MCP |
| `api` | Integrazione API diretta |

## ID dei payment link

Ogni payment link ha un ID con prefisso `plink_`, per esempio `plink_019dbc4d828174419d9ff9fae24aea7b`. Compare nell'URL della dashboard quando il link è aperto, nelle risposte degli strumenti MCP e nei payload dei webhook, ed è l'ultima parte dell'URL rivolto al cliente: `https://<il tuo dominio di ordinazione>/pay/plink_…`.

## Sviluppatori

### Strumenti MCP

Gli assistenti AI collegati usano questi strumenti; consulta [MCP tools](/docs/it/developers/mcp/tools) per i parametri.

| Tool | Tipo |
| - | - |
| `list-payment-links` | Read |
| `get-payment-link` | Read |
| `create-payment-link` | Write: l'assistente chiede l'approvazione a meno che tu non l'abbia auto-consentito |
| `get-payment-link-qr` | Read: restituisce un PNG |

### Eventi webhook

| Evento | Attivato quando |
| - | - |
| `payment_link.created` | Viene creato un payment link |
| `payment_link.paid` | Viene riscosso un pagamento tramite un link |
| `payment_link.refund.created` | Viene richiesto un rimborso |
| `payment_link.refund.succeeded` | Il gateway di pagamento conferma il rimborso |
| `payment_link.refund.failed` | Il gateway di pagamento rifiuta il rimborso |

I payload sono documentati in [Eventi webhook](/docs/it/developers/webhooks/webhook-events#payments-events).


## Related topics

- [Rimborsi e transazioni dei payment link](/docs/it/payment-links/refunds-and-transactions.md)
- [Gestire i payment link](/docs/it/payment-links/managing-payment-links.md)
- [Panoramica dei payment link](/docs/it/payment-links/overview.md)
- [Eventi webhook](/docs/it/developers/webhooks/webhook-events.md)
- [Risoluzione dei problemi](/docs/it/guides/integrations/pos/comtrex/troubleshooting.md)


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