# Pontos na Loja

> Os pontos do envolvimento passam a moeda na Loja. O saldo de cada pessoa, o preço em pontos, o resgate, o estorno, o que nunca acontece com os pontos e o aviso fiscal.

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.

| Onde | O quê |
|---|---|
| **Membros › Gamificação**, cartão **Saldo de pontos** | Ligar, **O nome da moeda** e **Como o saldo começa** (**Com os pontos que cada um já tem hoje** ou **Do zero**), com o total em circulação; **Guardar saldo**. Proprietário e administrador |
| O produto, em **Como é pago** | **Dinheiro**, **Pontos** ou **Pontos ou dinheiro**, e o **Preço em pontos** |
| A Loja | O cartão mostra *"ou N pontos"* e o botão **Resgatar com pontos**; sem saldo suficiente, *"Faltam N pontos"*. A janela de resgate mostra **O seu saldo** e **Saldo depois** |
| **A Minha Conta › Os meus pontos** | O saldo, os pontos, o nível e o extrato de ganhos e gastos |
| A página do membro, no menu | **Extrato de pontos** de outra pessoa, para o proprietário e o administrador |

## Pontos e saldo

Cada pessoa passa a ter duas contas:

| | O que é | O que muda |
|---|---|---|
| **Pontos** | Tudo o que a pessoa já ganhou na [gamificação](/membros/gamificacao) | Ranking, nível, acesso por nível e badges. **Gastar nunca diminui os pontos** |
| **Saldo** | A parte dos pontos que ainda pode ser gasta | Cada ponto ganho entra no saldo; uma compra retira; um estorno devolve |

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](/membros/gamificacao) 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:

| Forma | O que a pessoa vê |
|---|---|
| **Dinheiro** (a predefinição) | Como sempre |
| **Pontos** | Só o preço em pontos |
| **Pontos ou dinheiro** | As duas formas; a pessoa escolhe |

- **Aceitam pontos** os produtos de pagamento único: digital (mentoria, hotseat, experiência), físico, bilhete de [evento](/espacos/eventos) (o preço é por tipo de bilhete), [curso](/espacos/cursos) e [download](/espacos/downloads).
- **Não aceitam:** subscrição, parcelado, reserva (que tem os [créditos](/monetizacao/creditos)), [adicionais](/monetizacao/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.
- Em **Monetização › Produtos**, a lista mostra um produto só em pontos pelo preço em pontos (*"2000 pontos"*, com o nome que a comunidade deu à moeda), e um produto em **Pontos ou dinheiro** com *"ou 2000 pontos"* por baixo do preço. Ao editar, o formulário abre com a forma escolhida (**Pontos**, por exemplo) e o preço em pontos.

## 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](/pagamentos/reembolsos-e-contestacoes)). 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.

> [!WARNING]
> **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

| Ação | Quem |
|---|---|
| Ligar, dar nome à moeda, escolher como o saldo começa | Proprietário e administrador |
| Dar preço em pontos a um produto | Quem cria e edita produtos |
| Resgatar | Membro, com saldo |
| Ver o saldo e o extrato de outra pessoa | Proprietário e administrador |
| Estornar | A equipa, como numa compra em dinheiro |

## 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](/api/webhooks).

## Pelo assistente (MCP)

Peça para ligar os pontos como moeda (*"ative os pontos como moeda, com o nome moedas"*, [`update_points_settings`](/mcp/ferramentas-conteudo#update-points-settings)), dar preço em pontos a um produto (`pricing_mode` e `points_price` em [`create_product`](/mcp/ferramentas-vendas#create-product)), ver o saldo de alguém ([`get_member_points`](/mcp/ferramentas-conteudo#get-member-points)) ou o seu ([`get_my_points`](/mcp/ferramentas-conteudo#get-my-points)), e resgatar um produto ([`redeem_product_with_points`](/mcp/ferramentas-vendas#redeem-product-with-points), com confirmação). O reembolso de uma compra com pontos é [`refund_purchase`](/mcp/ferramentas-financeiro#refund-purchase).

## Relacionados

- [Gamificação](/membros/gamificacao)
- [Produtos](/monetizacao/produtos)
- [Loja](/espacos/loja)
- [Reembolsos e contestações](/pagamentos/reembolsos-e-contestacoes)