Catalogo prodotti¶

Un prodotto è l’elemento riutilizzabile dietro tutto ciò che vendi: un piano SaaS, un bene fisico, un servizio o un’offerta una tantum. Definisci una volta e collegalo a link di pagamento, piani di abbonamento o sessioni di checkout invece di ripetere gli stessi dati per ogni addebito.

In sintesi

Per chi: team che vendono uno o più prodotti o servizi.
Tempo: 5 minuti.
Risultato: un prodotto riutilizzabile pronto per piani e link di pagamento.

Per chi
Founder, operations e sviluppo

Tempo
5 minuti

Livello
Principiante

Risultato
Catalogo riutilizzabile

Cos’è un prodotto?¶

Un prodotto memorizza nome, descrizione e stato di ciò che vendi. Piani e link di pagamento fanno riferimento al prodotto invece di duplicarne le informazioni.

Un’unica fonte di verità — aggiorna il prodotto una volta e riutilizzalo.
Report più chiari — raggruppa i ricavi per prodotto invece che per singolo addebito.
Configurazione più rapida — crea un piano o un link senza riscrivere l’offerta.

Disponibilità nella console

Il catalogo è disponibile oggi tramite API. La vista nella console viene distribuita per workspace. Se non vedi ancora Payments → Products, usa l’API o contatta il supporto per abilitarla.

Creare un prodotto¶

APIConsole

curl -X POST 'https://api.4geeks.io/v1/products' \
  -H 'X-Api-Key: sk_test_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Piano Premium",
    "description": "Abbonamento mensile con tutte le funzionalità",
    "active": true
  }'

La risposta restituisce l’id del prodotto, da usare quando crei un piano o un link di pagamento.

Apri la Console 4Geeks.
Vai su Payments → Products.
Seleziona New product.
Inserisci un nome e una descrizione opzionale.
Salva il prodotto e copia l’ID.

Campi del prodotto¶

Campo	Tipo	Obbligatorio	Note
`name`	string	Sì	Nome visibile al cliente
`description`	string	No	Breve spiegazione di ciò che riceve il cliente
`active`	boolean	No	Predefinito `true`; un prodotto inattivo non può essere venduto

Prodotti, piani e link di pagamento¶

Se ti serve…	Usa…	Perché
Un addebito una tantum con descrizione riutilizzabile	Prodotto + link di pagamento	Condividi una URL senza ricostruire l’offerta
Un abbonamento ricorrente	Prodotto + piano	Il piano aggiunge importo, valuta e intervallo
Un checkout completamente personalizzato	Prodotto + sessione di checkout	Controlli l’esperienza nella tua app

Gestisci il catalogo¶

Elenca i prodotti con GET /v1/products e pagina con limit e offset.
Disattiva un prodotto invece di eliminarlo per conservare lo storico.
Mantieni nomi stabili — compaiono in checkout, ricevute e report.

Domande frequenti¶

Posso modificare un prodotto dopo aver creato un piano?

Sì. Puoi aggiornare nome e descrizione. Il prezzo risiede nel piano, quindi cambiare l’importo non richiede un nuovo prodotto.

I link di pagamento richiedono un prodotto?

No. I link di pagamento possono essere creati solo con descrizione e importo. I prodotti sono consigliati quando vuoi un catalogo riutilizzabile e report coerenti.

Cosa succede se disattivo un prodotto?

Piani e link esistenti mantengono lo storico, ma i nuovi checkout devono usare un prodotto attivo.

Correlati¶

Crea il tuo primo prodotto

Hai ancora domande? Chiedi su Discord o esplora i tutoriali.