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

# Crea e condividi link di pagamento storekit

> Crea link di pagamento storekit condivisibili per raccogliere pagamenti una tantum o riutilizzabili dai clienti. Invia via email, SMS o chat — nessun ordine richiesto al checkout.

Usa i link di pagamento per raccogliere pagamenti al di fuori del normale flusso degli ordini. Condividi un link via email o SMS e il tuo cliente paga direttamente tramite una pagina di checkout ospitata — nessun ordine richiesto.

## Tipi di link

I link di pagamento sono di due tipi:

| Tipo               | Descrizione                                                                           |
| ------------------ | ------------------------------------------------------------------------------------- |
| **Una tantum**     | Si disattiva automaticamente dopo un singolo pagamento riuscito                       |
| **Riutilizzabile** | Rimane attivo e accetta più pagamenti (facoltativamente fino a un limite configurato) |

## Tipi di importo

| Tipo          | Descrizione                                                                                                   |
| ------------- | ------------------------------------------------------------------------------------------------------------- |
| **Fisso**     | Un importo prestabilito che il cliente deve pagare                                                            |
| **Variabile** | Il cliente inserisce l'importo al checkout, facoltativamente entro un intervallo minimo/massimo che configuri |

## Creazione di un link di pagamento

<Info>
  La sezione **Payments > Payment Links** è visibile nella tua dashboard solo dopo che storekit Payments è stato attivato sul tuo negozio. Se non la vedi, attiva prima i pagamenti tramite **Store Settings > Payments > Activate Payments**. Consulta [Configura i pagamenti](/docs/it/getting-started/launch/set-up-payments) per le istruzioni complete di configurazione.
</Info>

<Steps>
  <Step title="Apri i link di pagamento">
    Vai a **Payments > Payment Links** nella tua dashboard e clicca su **Create link**.
  </Step>

  <Step title="Configura il link">
    Compila i dettagli del link:

    * **Title** — mostrato al cliente al checkout (obbligatorio)
    * **Description** — contesto opzionale mostrato sotto il titolo
    * **Reference** — un riferimento interno per i tuoi registri (ad es. un numero di fattura)
    * **Type** — una tantum o riutilizzabile
    * **Amount type** — fisso o variabile
    * **Amount** — obbligatorio per link fissi; inserisci nella valuta del tuo negozio
    * **Min / Max amount** — limiti opzionali per link variabili
    * **Max payments** — limite opzionale sui pagamenti totali per link riutilizzabili
    * **Expiry date** — data opzionale dopo la quale il link diventa inattivo
    * **Image** — immagine opzionale mostrata sulla pagina di checkout
    * **Customer details** — raccogli facoltativamente nome dell'attività, nome del cliente, email e telefono al checkout (vedi [Raccolta dei dati del cliente](#customer-detail-collection))
  </Step>

  <Step title="Configura il comportamento post-pagamento">
    Scegli cosa succede dopo un pagamento riuscito:

    * **Thank you page** — mostra un messaggio di ringraziamento personalizzabile (predefinito)
    * **Redirect** — invia il cliente a un URL a tua scelta
  </Step>

  <Step title="Condividi il link">
    Una volta creato, copia l'URL del link o usa l'opzione **Send** per consegnarlo via email o SMS.
  </Step>
</Steps>

## Invio di un link

Puoi inviare un link di pagamento direttamente dalla dashboard:

1. Apri il link di pagamento da **Payments > Payment Links**
2. Clicca su **Send**
3. Inserisci l'indirizzo email o il numero di telefono del cliente
4. Clicca su **Send link**

Il cliente riceve un messaggio con un link diretto alla pagina di checkout.

## Stati del link

| Stato        | Descrizione                                                                  |
| ------------ | ---------------------------------------------------------------------------- |
| **Active**   | Il link è attivo e accetta pagamenti                                         |
| **Inactive** | Il link è stato disattivato manualmente, o un link una tantum è stato pagato |
| **Expired**  | La data di scadenza del link è passata                                       |

## Disattivazione di un link

Per interrompere l'accettazione dei pagamenti da parte di un link, aprilo da **Payments > Payment Links** e clicca su **Deactivate**. I link disattivati restituiscono un messaggio "no longer active" a chiunque li visiti.

## Raccolta dei dati del cliente

Puoi configurare un link di pagamento per raccogliere informazioni sul cliente al checkout. Ogni campo può essere impostato indipendentemente su una delle tre modalità:

| Modalità   | Descrizione                                                           |
| ---------- | --------------------------------------------------------------------- |
| `disabled` | Il campo non viene mostrato al checkout (predefinito)                 |
| `optional` | Il campo viene mostrato ma non è obbligatorio                         |
| `required` | Il campo deve essere compilato prima che il pagamento possa procedere |

I campi disponibili sono:

* **Business name** — il nome dell'azienda o del nome commerciale del cliente
* **Customer name** — il nome completo del cliente
* **Email** — l'indirizzo email del cliente
* **Phone** — il numero di telefono del cliente

I dati raccolti vengono memorizzati con ciascun record di pagamento e sono visibili nella scheda **Transactions**.

## Codici QR

Ogni link di pagamento ha un codice QR che codifica l'URL del checkout. Puoi scaricare il codice QR come immagine PNG dalla pagina di dettaglio del link di pagamento, o generarlo tramite l'API o lo strumento MCP `get-payment-link-qr`.

Il codice QR è utile per la stampa su fatture, ricevute o cartelli fisici in modo che i clienti possano scansionare e pagare direttamente.

## Rimborsi

Puoi emettere un rimborso per qualsiasi pagamento raccolto tramite un link di pagamento:

1. Apri il link di pagamento da **Payments > Payment Links**
2. Vai alla scheda **Transactions**
3. Seleziona il pagamento che vuoi rimborsare
4. Clicca su **Refund** e inserisci l'importo

I rimborsi parziali sono supportati. Lo stato del pagamento viene aggiornato di conseguenza a **Partially refunded** o **Fully refunded**.

## Visualizzazione delle transazioni

Ogni link di pagamento ha una scheda **Transactions** che mostra tutti i pagamenti ricevuti, incluso l'importo, la valuta, il riferimento del pagamento e qualsiasi dettaglio del cliente raccolto.

## ID dei link di pagamento

I link di pagamento utilizzano un ID con prefisso `plink_` (ad esempio, `plink_019dbc4d828174419d9ff9fae24aea7b`). Usa questo ID quando fai riferimento a un link tramite l'API o i webhook.

## Eventi webhook

storekit attiva i seguenti eventi webhook per i link di pagamento:

| Evento                          | Descrizione                                                                           |
| ------------------------------- | ------------------------------------------------------------------------------------- |
| `payment_link.created`          | Attivato quando viene creato un nuovo link di pagamento                               |
| `payment_link.paid`             | Attivato quando un pagamento viene raccolto con successo tramite un link di pagamento |
| `payment_link.refund.created`   | Attivato quando viene avviato un rimborso per un pagamento di un link di pagamento    |
| `payment_link.refund.succeeded` | Attivato quando il gateway di pagamento conferma il successo del rimborso             |
| `payment_link.refund.failed`    | Attivato quando il gateway di pagamento rifiuta un rimborso                           |

Consulta [Webhook Events](/docs/it/developers/webhooks/webhook-events) per i riferimenti completi al payload.

## Accesso API e MCP

I link di pagamento sono disponibili tramite l'API storekit e gli strumenti MCP. Puoi:

* Elencare i link di pagamento (filtra per venue, stato o tipo)
* Ottenere un singolo link di pagamento tramite ID
* Creare un nuovo link di pagamento
* Generare un codice QR per un link di pagamento (`get-payment-link-qr`)

Consulta l'[Introduzione per sviluppatori](/docs/it/developers/introduction) per ulteriori informazioni sull'accesso API e MCP.


## Related topics

- [Ordini in contanti e pagamento al ritiro](/docs/it/guides/payments/cash-payments.md)
- [Trova e condividi l'URL del tuo store storekit](/docs/it/guides/store-settings/store-url.md)
- [Mance e coperto](/docs/it/guides/payments/tips-service-charges.md)
- [Rimborsi e payout](/docs/it/guides/payments/refunds-payouts.md)
- [Guida rapida](/docs/it/getting-started/quick-start-guide.md)