# Punti nel Negozio

> I punti del coinvolgimento diventano moneta nel Negozio. Il saldo di ogni persona, il prezzo in punti, il riscatto, lo storno, ciò che non succede mai con i punti e l'avviso fiscale.

Con i **punti nel Negozio**, i punti che la persona guadagna partecipando valgono qualcosa di concreto: una mentorship, un biglietto, una maglietta, un corso. Il team dà a un prodotto un **prezzo in punti**, oltre al prezzo in denaro o al suo posto, e la persona lo **riscatta** con il proprio saldo.

| Dove | Cosa |
|---|---|
| **Membri › Gamification**, scheda **Saldo punti** | Attivare, **Il nome della moneta** e **Come parte il saldo** (**Con i punti che ognuno ha già oggi** o **Da zero**), con il totale in circolazione; **Salva saldo**. Proprietario e amministratore |
| Il prodotto, in **Come si paga** | **Denaro**, **Punti** o **Punti o denaro**, e il **Prezzo in punti** |
| Il Negozio | La scheda mostra *"o N punti"* e il pulsante **Riscatta con punti**; senza saldo sufficiente, *"Mancano N punti"*. La finestra di riscatto mostra **Il tuo saldo** e **Saldo dopo** |
| **Il mio account › I miei punti** | Il saldo, i punti, il livello e l'estratto di guadagni e spese |
| La pagina del membro, nel menu | L'**Estratto punti** di un'altra persona, per il proprietario e l'amministratore |

## Punti e saldo

Ogni persona ha due conti:

| | Cos'è | Cosa cambia |
|---|---|---|
| **Punti** | Tutto ciò che la persona ha già guadagnato nella [gamification](/membros/gamificacao) | Classifica, livello, accesso per livello e badge. **Spendere non diminuisce mai i punti** |
| **Saldo** | La parte dei punti che si può ancora spendere | Ogni punto guadagnato entra nel saldo; un acquisto lo toglie; uno storno lo restituisce |

Tutto ciò che toglie punti (togliere un mi piace, eliminare un post, una correzione negativa) toglie anche saldo, quindi **il saldo può diventare negativo**. Con il saldo negativo, la persona non riscatta nulla finché non torna positivo.

**Correzione del team su se stessi.** Una correzione positiva di punti che qualcuno del team si assegna conta nei punti, ma **non nel saldo**: nessuno del team si dà punti per svuotare il Negozio. La correzione fatta da un workflow non conta come "su se stessi".

## Attivare

La funzione nasce **disattivata**, e solo il proprietario e l'amministratore la attivano. Alla prima attivazione scegli:

- **Il nome della moneta**: *punti* (predefinito), *monete*, *PapoCoins*…
- **Come parte il saldo**: con i punti che ogni persona **ha già oggi**, oppure **da zero** (da quel momento, solo ciò che viene guadagnato). La scelta vale una volta: disattivare e riattivare non riapre il saldo, che continua da dove era.

Prima di salvare, l'anteprima mostra quanti punti sono in circolazione. Con la [gamification](/membros/gamificacao) disattivata, i punti e il saldo si congelano, e un prodotto solo in punti diventa non disponibile.

## Il prezzo in punti

Ogni prodotto sceglie come si paga:

| Modalità | Cosa vede la persona |
|---|---|
| **Denaro** (predefinita) | Come sempre |
| **Punti** | Solo il prezzo in punti |
| **Punti o denaro** | Le due modalità; la persona sceglie |

- **Accettano punti** i prodotti a pagamento unico: digitale (mentorship, hotseat, esperienza), fisico, biglietto di un [evento](/espacos/eventos) (il prezzo è per tipo di biglietto), [corso](/espacos/cursos) e [download](/espacos/downloads).
- **Non li accettano:** abbonamento, rateale, prenotazione (che ha i [crediti](/monetizacao/creditos)), [componenti aggiuntivi](/monetizacao/adicionais) e opzioni di piano.
- Non c'è pagamento misto (parte in punti e parte in denaro). Il coupon non vale sul prezzo in punti, e un'azienda non acquista con i punti: i punti sono della persona.
- Scorte, posti, lotto di biglietti e "1 per persona" valgono come nell'acquisto in denaro.
- In **Monetizzazione › Prodotti**, l'elenco mostra un prodotto solo in punti con il prezzo in punti (*"2.000 punti"*, con il nome che la community ha dato alla valuta), e un prodotto in **Punti o denaro** con *"o 2.000 punti"* sotto il prezzo. In modifica, il modulo si apre con la forma scelta (**Punti**, per esempio) e il prezzo in punti.

## Il riscatto

- La persona vede il prezzo in punti e, quando non ne ha abbastanza, **quanti ne mancano**.
- Ogni riscatto è **un'unità**. Un prodotto fisico chiede l'indirizzo di consegna.
- Il riscatto segue le stesse regole di accesso dell'acquisto in denaro: un prodotto di un Negozio che la persona non apre, oppure un corso, un evento o un download di uno spazio chiuso per lei, non si può riscattare.
- L'acquisto risulta **completato subito**, con l'accesso concesso come in un acquisto gratuito. **Non passa dal processore di pagamento**, non ha la commissione della piattaforma e non entra nelle entrate, nel saldo da ricevere né nei prelievi.
- La persona riceve l'e-mail di acquisto, con *"N punti"* al posto dell'importo. Nelle vendite della community, l'acquisto compare come **pagato con punti**.

## Storno

Solo il team storna un acquisto con punti, come un acquisto in denaro (vedi [Rimborsi e contestazioni](/pagamentos/reembolsos-e-contestacoes)). Lo storno è **totale**: restituisce tutti i punti al saldo, toglie l'accesso e rimette l'unità in magazzino. Non esiste lo storno parziale.

## Ciò che non succede mai con i punti

I punti **non si comprano** con denaro, **non diventano denaro** e **non si trasferiscono** tra persone. Sono un programma di coinvolgimento della community, non un mezzo di pagamento.

> [!WARNING]
> **Avviso fiscale.** L'acquisto con punti ha valore in denaro pari a zero: Memberfy non emette alcun documento fiscale per esso. Consegnare un prodotto fisico o un servizio in cambio di punti è un obbligo della community (come un documento di trasporto o di omaggio, quando previsto). Consulta il tuo commercialista: Memberfy non fornisce indicazioni sulle regole fiscali.

## Esempi

**Mentorship a punti.** La community crea il prodotto *Hotseat di 30 min* (digitale, 1 per persona, scorte 10), solo in punti: 2.000. Anna ha 3.400 punti e saldo 3.400; lo riscatta. Il saldo scende a 1.400, mentre i punti e il livello restano 3.400.

**Biglietto con le due modalità.** Il *Meetup SP* costa R$ 40 o 800 punti. Bruno, con saldo 300, vede che mancano 500 punti e paga con PIX.

## Chi può

| Azione | Chi |
|---|---|
| Attivare, dare il nome alla moneta, scegliere come parte il saldo | Proprietario e amministratore |
| Dare un prezzo in punti a un prodotto | Chi crea e modifica prodotti |
| Riscattare | Membro, con saldo |
| Vedere il saldo e l'estratto di un'altra persona | Proprietario e amministratore |
| Stornare | Il team, come per un acquisto in denaro |

## Nell'API

- `GET` e `PUT /api/points/settings` (proprietario e amministratore): `enabled`, `currencyName` e la partenza del saldo (`current`, i punti di oggi, o `zero`), con la circolazione e l'anteprima.
- `GET /api/points/me` e `GET /api/points/members/{memberId}` (la persona stessa, oppure proprietario e amministratore): saldo, punti, livello e l'estratto di guadagni, spese, storni, aperture e correzioni escluse.
- Prodotto: `pricingMode` (`MONEY`, il predefinito, `POINTS` o `POINTS_OR_MONEY`) e `pointsPrice`; fuori dai tipi accettati, `400` in `pricingMode`. Un prodotto solo in punti ha `price` 0.
- `POST /api/storefront/products/{productId}/redeem` (il membro; `Idempotency-Key` facoltativo, la stessa chiave restituisce lo stesso acquisto): l'acquisto `COMPLETED` con `paymentMethod: "POINTS"` e `pointsPaid`. Saldo insufficiente: `400` `points.insufficient`, con `data.missing`; funzione o gamification disattivate: `409`. Fuori dalle regole di accesso, `403` `monetization.purchase.notPurchasable`.
- Il checkout in denaro, l'acquisto gratuito e il coupon rifiutano un prodotto solo in punti.
- La vetrina porta `pricingMode`, `pointsPrice`, `free`, `pointsAvailable` e `pointsShortfall`; gli acquisti, `paidWithPoints` e `pointsPaid`. Lo storno di un acquisto con punti risponde `source: "POINTS"` e `pointsReturned`.
- Webhook: `purchase.completed` con `pointsPaid` e `purchase.refunded` con `paymentMethod: "POINTS"` e `pointsReturned`, solo negli acquisti con punti. Vedi [Webhook](/api/webhooks).

## Con l'assistente (MCP)

Chiedi di attivare i punti come moneta (*"attiva i punti come moneta, chiamati monete"*, [`update_points_settings`](/mcp/ferramentas-conteudo#update-points-settings)), di dare un prezzo in punti a un prodotto (`pricing_mode` e `points_price` in [`create_product`](/mcp/ferramentas-vendas#create-product)), di vedere il saldo di qualcuno ([`get_member_points`](/mcp/ferramentas-conteudo#get-member-points)) o il tuo ([`get_my_points`](/mcp/ferramentas-conteudo#get-my-points)), e di riscattare un prodotto ([`redeem_product_with_points`](/mcp/ferramentas-vendas#redeem-product-with-points), con conferma). Il rimborso di un acquisto con punti è [`refund_purchase`](/mcp/ferramentas-financeiro#refund-purchase).

## Correlati

- [Gamification](/membros/gamificacao)
- [Prodotti](/monetizacao/produtos)
- [Negozio](/espacos/loja)
- [Rimborsi e contestazioni](/pagamentos/reembolsos-e-contestacoes)