Pontos de fidelidade e o extrato de pontos
Como a API credita pontos por nota e por que o saldo de pontos pode ficar negativo
O que e?
É a modalidade Pontos: cada nota cadastrada credita pontos ao participante, num extrato próprio, e o total fica guardado por participação. Os pontos são depois trocados por produto na vitrine de resgate. A quantidade de pontos vem da regra de geração, como em todas as outras modalidades.
A modalidade Pontos tem regulamento próprio, ao lado dos regulamentos de sorteio e de vale-brinde. Quando o participante aceita os termos, o registro do aceite guarda os regulamentos que a campanha tinha publicados naquele momento, inclusive o de pontos.
Como funciona?
Cada movimento de pontos tem sinal e guarda o saldo de antes e o de depois, e o banco confere a conta. O saldo só muda por um caminho, que recusa qualquer lançamento que não parta do saldo atual — dois lançamentos simultâneos não passam juntos.
O crédito é uma vez por nota. Reenviar a mesma nota não credita de novo.
Há uma base de geração específica para pontos, que soma as unidades de cada produto da nota multiplicadas pelos pontos por unidade configurados no vínculo do produto com a campanha. O vínculo com rede só vale na nota daquela rede; com dois vínculos do mesmo produto, vale o maior. Essa base vale em qualquer modalidade — no Sorteio, cada ponto é um número — e não acumula saldo.
O limite do participante na modalidade Pontos é sobre o que ele ganhou por nota (créditos menos estornos), não sobre o saldo. Gastar num resgate não abre vaga para ganhar mais.
Cancelar a nota estorna os pontos, e o saldo pode ficar negativo. Isso é decisão de produto, não bug: os pontos podem já ter virado prêmio resgatado, e o participante só volta a resgatar quando repuser. O saldo negativo é o registro de que o prêmio saiu sem lastro.
O operador do cliente pode ajustar pontos, com sinal e com motivo obrigatório, e cada ajuste fica no extrato com quem fez e por quê. Isso é diferente do ajuste de saldo em reais, que é restrito à equipe Premify: corrigir ponto é atendimento do programa de fidelidade. Um débito que deixaria o saldo negativo é recusado — o negativo só nasce do estorno de nota.
No extrato do painel, cada linha diz de onde os pontos vieram ou para onde foram: o crédito e o estorno dos pontos de boas-vindas mostram o convite de origem, e o resgate e a devolução mostram o nome do prêmio como ficou registrado no pedido. Isso permite ao operador entender um movimento sem abrir outras telas.
O que o participante vê é o extrato sem motivo e sem autor: esses dois campos são anotação interna do operador.
Os pontos valem até o fim da campanha. O prazo para resgatar é configurável e está no artigo de resgate.
Regra com saldo de reais ou de unidades não é aceita na modalidade Pontos, nem as bases sem nota (story e cadastro). A configuração recusa no vínculo, para não aceitar algo que não renderia.
Quando o participante sai da campanha pelo hotsite, os pontos de boas-vindas de convite são estornados, mas o saldo que sobra de ajuste manual fica parado: nenhum movimento novo é criado para zerá-lo, e a tela de quem saiu não mostra saldo. Zerar seria um movimento sem contraparte.
Como explicar ao cliente?
Pontos são uma modalidade da campanha, com extrato próprio, separado dos números da sorte e das posições premiadas, e com regulamento próprio. Cada nota credita uma vez, e a quantidade vem da regra de geração — a mesma estrutura das outras modalidades, com os mesmos cuidados para alterar com a campanha no ar.
Dois pontos que geram pergunta. O primeiro: o limite de pontos do participante conta o que ele ganhou, não o que ele tem. Quem resgatou não ganha espaço para acumular mais — se ganhou o máximo e gastou tudo, não ganha novamente.
O segundo: se uma nota é cancelada depois de o participante ter resgatado, o saldo dele pode ficar negativo. É proposital: o prêmio já saiu, e o negativo registra isso. Ele volta a resgatar quando o saldo cobrir o custo.
O operador do cliente pode corrigir pontos pelo painel, com motivo. Esse motivo não aparece ao participante. E o extrato do painel mostra o convite ou o prêmio ligado a cada movimento.
Possiveis falhas, causas e solucoes
- Falha: o participante diz que o saldo de pontos dele está negativo.
- Possivel causa: alguma nota dele foi cancelada depois de ele ter resgatado, ou ele saiu da campanha depois de resgatar com pontos de boas-vindas. O estorno levou o saldo abaixo de zero de propósito, porque o prêmio já havia saído.
- Como orientar: explique que o prêmio já foi entregue e que o saldo volta ao positivo quando ele acumular de novo. O extrato mostra o estorno.
- Quando escalar: se o saldo estiver negativo sem nenhum estorno no extrato, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.
- Falha: o participante resgatou pontos e não consegue mais ganhar pontos novos.
- Possivel causa: ele atingiu o limite de pontos da regra de geração. O limite conta o que ele ganhou por nota, não o saldo — gastar não abre vaga.
- Como orientar: confira o limite de participação na regra da modalidade Pontos. Se o cliente quiser permitir mais, a alteração da regra vale só para as notas cadastradas depois.
- Quando escalar: não é falha. Só escalar se o limite estiver em branco e o crédito continuar barrado.
- Falha: o operador tentou debitar pontos pelo painel e o sistema recusou.
- Possivel causa: o débito deixaria o saldo negativo. O negativo só nasce do estorno, nunca de ajuste manual.
- Como orientar: confira o saldo atual antes do ajuste. Se o objetivo é retirar pontos de uma nota específica, o caminho é cancelar a nota, que estorna o crédito dela.
- Quando escalar: não é falha. Só escalar se a recusa aparecer num débito que cabe no saldo.
- Falha: o produto da nota não gerou os pontos esperados.
- Possivel causa: o produto não está vinculado à campanha, está sem pontos por unidade configurados, ou o vínculo é de uma rede diferente da rede da nota.
- Como orientar: confira o vínculo do produto com a campanha e os pontos por unidade. O vínculo com rede só vale na nota daquela rede.
- Quando escalar: se o vínculo estiver correto e os pontos não saírem, abrir issue no Jira (projeto DEV) com as evidências.
- Falha: o participante reenviou a mesma nota esperando creditar pontos de novo.
- Possivel causa: o crédito é uma vez por nota.
- Como orientar: explique que cada compra credita uma única vez. Se a nota foi cancelada e recadastrada, ela vale como nota nova e credita de novo.
- Quando escalar: não é falha. Só escalar se a mesma nota ativa aparecer com dois créditos no extrato.
- Falha: o operador quer ajustar o saldo em reais de um participante e não encontra a opção.
- Possivel causa: o ajuste de saldo em reais é restrito à equipe Premify. O ajuste do operador do cliente é o de pontos.
- Como orientar: oriente o cliente a pedir o ajuste de saldo em reais pelo atendimento. O ajuste de pontos ele faz no painel, com motivo.
- Quando escalar: não é falha. Se o cliente precisar do ajuste de saldo em reais, abrir issue no Jira (projeto DEV) com o caso e as evidências.
Exemplo de resposta pronta
Olá! Nessa campanha cada compra cadastrada credita pontos uma única vez, e a quantidade vem da regra da promoção. No seu extrato de pontos você vê cada crédito e cada troca. Duas coisas que costumam gerar dúvida: o limite de pontos da promoção conta quanto você ganhou, e não quanto você tem — resgatar não libera espaço para ganhar mais. E se uma das suas notas for cancelada depois de você já ter resgatado um prêmio, seu saldo pode ficar negativo: o prêmio já foi entregue, e você volta a poder resgatar quando acumular de novo.
Quando escalar?
Acione o time de desenvolvimento urgentemente e abra issue no Jira (projeto DEV) com as evidências quando o saldo de pontos estiver negativo sem estorno no extrato, quando a mesma nota ativa gerar dois créditos, quando a soma do extrato não fechar com o saldo exibido, ou quando o produto estiver vinculado com pontos por unidade e não creditar. Anexe o nome da campanha, o CPF ou CNPJ do participante, o número da nota e prints do extrato.
Artigos relacionados
Como o pedido de resgate debita pontos e reserva estoque e as situações dele até a entrega
Como o valor que não fecha uma chance fica guardado e como o extrato explica cada movimento
As modalidades da campanha e as regras de geração que transformam nota cadastro story ou comunidade em chance