Riferimento dei payment link

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.

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.

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

​Tipi di link

​Modalità di prezzo

​Stati del link

​Stati delle transazioni

​Campi di creazione

​Modalità dei campi cliente

​Da dove arrivano i link

​ID dei payment link

​Sviluppatori

​Strumenti MCP

​Eventi webhook