Pontos na Loja

Com pontos na Loja, os pontos que a pessoa ganha ao participar passam a valer algo concreto: uma mentoria, um bilhete, uma t-shirt, um curso. A equipa dá a um produto um preço em pontos, além do preço em dinheiro ou em vez dele, e a pessoa resgata-o com o seu saldo.

#Pontos e saldo

Cada pessoa passa a ter duas contas:

Tudo o que retira pontos (retirar um gosto, apagar uma publicação, um ajuste negativo) retira também saldo, por isso o saldo pode ficar negativo. Com saldo negativo, a pessoa não resgata nada até voltar a ficar positivo.

Ajuste da equipa a si própria. Um ajuste positivo de pontos que alguém da equipa dá a si próprio conta nos pontos, mas não no saldo: ninguém da equipa se dá pontos para esvaziar a Loja. O ajuste feito por um workflow não conta como "a si própria".

#Ligar

O recurso nasce desligado, e só o proprietário e o administrador o ligam. Ao ligar pela primeira vez, escolhe:

• O nome da moeda: pontos (a predefinição), moedas, PapoCoins…
• Como o saldo começa: com os pontos que cada pessoa já tem hoje, ou do zero (a partir daí, só o que for ganho). A escolha vale uma vez: desligar e voltar a ligar não reabre o saldo, que continua onde estava.

Antes de guardar, a pré-visualização mostra quantos pontos estão em circulação. Com a gamificação desligada, os pontos e o saldo ficam congelados, e um produto só em pontos fica indisponível.

#O preço em pontos

Cada produto escolhe como se paga:

• Aceitam pontos os produtos de pagamento único: digital (mentoria, hotseat, experiência), físico, bilhete de evento (o preço é por tipo de bilhete), curso e download.
• Não aceitam: subscrição, parcelado, reserva (que tem os créditos), adicionais e opções de plano.
• Não há pagamento misto (parte em pontos e parte em dinheiro). O cupão não vale no preço em pontos, e uma empresa não compra com pontos: os pontos são da pessoa.
• Stock, vagas, lote de bilhetes e "1 por pessoa" valem como na compra em dinheiro.

#O resgate

• A pessoa vê o preço em pontos e, quando não tem o suficiente, quanto falta.
• Cada resgate é uma unidade. Um produto físico pede a morada de entrega.
• O resgate segue as mesmas regras de acesso da compra em dinheiro: um produto de uma Loja que a pessoa não abre, ou um curso, evento ou download de um espaço fechado para ela, não pode ser resgatado.
• A compra fica concluída de imediato, com o acesso liberado como numa compra gratuita. Não passa pelo processador de pagamento, não tem taxa da plataforma e não entra na receita, no saldo a receber nem nos levantamentos.
• A pessoa recebe o e-mail de compra, com "N pontos" em vez do valor. Nas vendas da comunidade, a compra aparece como paga com pontos.

#Estorno

Só a equipa estorna uma compra com pontos, como uma compra em dinheiro (ver Reembolsos e contestações). O estorno é total: devolve todos os pontos ao saldo, retira o acesso e devolve a unidade ao stock. Não há estorno parcial.

#O que nunca acontece com os pontos

Os pontos não se compram com dinheiro, não se convertem em dinheiro e não se transferem entre pessoas. São um programa de envolvimento da comunidade, não um meio de pagamento.

Aviso fiscal. A compra com pontos tem valor em dinheiro zero: a Memberfy não emite documento fiscal por ela. Entregar um produto físico ou um serviço em troca de pontos é uma obrigação da comunidade (como uma guia de remessa ou de oferta, quando se aplique). Consulte o seu contabilista: a Memberfy não dá orientação sobre regras fiscais.

#Exemplos

Mentoria por pontos. A comunidade cria o produto Hotseat de 30 min (digital, 1 por pessoa, stock 10), só em pontos: 2.000. A Ana tem 3.400 pontos e saldo 3.400; resgata. O saldo passa para 1.400, e os pontos e o nível continuam em 3.400.

Bilhete com as duas formas. O Meetup SP custa R$ 40 ou 800 pontos. O Bruno, com saldo 300, vê que faltam 500 pontos e paga com PIX.

#Quem pode

#Na API

• GET e PUT /api/points/settings (proprietário e administrador): enabled, currencyName e o início do saldo (current, os pontos de hoje, ou zero), com a circulação e a pré-visualização.
• GET /api/points/me e GET /api/points/members/{memberId} (a própria pessoa, ou proprietário e administrador): saldo, pontos, nível e o extrato de ganhos, gastos, estornos, aberturas e ajustes excluídos.
• Produto: pricingMode (MONEY, a predefinição, POINTS ou POINTS_OR_MONEY) e pointsPrice; fora dos tipos aceites, 400 em pricingMode. Um produto só em pontos fica com price 0.
• POST /api/storefront/products/{productId}/redeem (o membro; Idempotency-Key opcional, a mesma chave devolve a mesma compra): a compra COMPLETED com paymentMethod: "POINTS" e pointsPaid. Saldo insuficiente: 400 points.insufficient, com data.missing; recurso ou gamificação desligados: 409. Fora das regras de acesso, 403 monetization.purchase.notPurchasable.
• O checkout em dinheiro, a compra gratuita e o cupão recusam um produto só em pontos.
• A montra traz pricingMode, pointsPrice, free, pointsAvailable e pointsShortfall; as compras, paidWithPoints e pointsPaid. O estorno de uma compra com pontos responde source: "POINTS" e pointsReturned.
• Webhooks: purchase.completed com pointsPaid e purchase.refunded com paymentMethod: "POINTS" e pointsReturned, só nas compras com pontos. Ver Webhooks.

#Pelo assistente (MCP)

Peça para ligar os pontos como moeda ("ative os pontos como moeda, com o nome moedas", update_points_settings), dar preço em pontos a um produto (pricing_mode e points_price em create_product), ver o saldo de alguém (get_member_points) ou o seu (get_my_points), e resgatar um produto (redeem_product_with_points, com confirmação). O reembolso de uma compra com pontos é refund_purchase.

#Relacionados

• Gamificação
• Produtos
• Loja
• Reembolsos e contestações