Punti nel Negozio

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.

#Punti e saldo

Ogni persona ha due conti:

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 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:

• Accettano punti i prodotti a pagamento unico: digitale (mentorship, hotseat, esperienza), fisico, biglietto di un evento (il prezzo è per tipo di biglietto), corso e download.
• Non li accettano: abbonamento, rateale, prenotazione (che ha i crediti), componenti aggiuntivi 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.

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

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ò

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

#Con l'assistente (MCP)

Chiedi di attivare i punti come moneta ("attiva i punti come moneta, chiamati monete", update_points_settings), di dare un prezzo in punti a un prodotto (pricing_mode e points_price in create_product), di vedere il saldo di qualcuno (get_member_points) o il tuo (get_my_points), e di riscattare un prodotto (redeem_product_with_points, con conferma). Il rimborso di un acquisto con punti è refund_purchase.

#Correlati

• Gamification
• Prodotti
• Negozio
• Rimborsi e contestazioni