Tipi di link
I link di pagamento sono di due tipi:Tipi di importo
Creazione di un link di pagamento
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 per le istruzioni complete di configurazione.
1
Apri i link di pagamento
Vai a Payments > Payment Links nella tua dashboard e clicca su Create link.
2
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)
3
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
4
Condividi il link
Una volta creato, copia l’URL del link o usa l’opzione Send per consegnarlo via email o SMS.
Invio di un link
Puoi inviare un link di pagamento direttamente dalla dashboard:- Apri il link di pagamento da Payments > Payment Links
- Clicca su Send
- Inserisci l’indirizzo email o il numero di telefono del cliente
- Clicca su Send link
Stati del link
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à:
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
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 MCPget-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:- Apri il link di pagamento da Payments > Payment Links
- Vai alla scheda Transactions
- Seleziona il pagamento che vuoi rimborsare
- Clicca su Refund e inserisci l’importo
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 prefissoplink_ (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:
Consulta 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)