Vitrin Digital — Manual da Plataforma

Guia para donos de organizações que utilizam a Vitrin Digital para processar pagamentos.


1. Acessando o Painel

Acesse https://vitrin.digital/login com o email e senha cadastrados no signup.

Após o login, você será redirecionado ao Dashboard com o resumo da sua operação.


2. Dashboard (Overview)

A página inicial mostra:

  • MRR — Receita recorrente mensal (soma dos planos ativos)
  • Assinaturas ativas — Quantos clientes assinam planos
  • Volume do período — Total cobrado no período selecionado (7d / 30d / 90d)
  • Churn — Taxa de cancelamento de assinaturas
  • Mix de pagamento — Distribuição entre Pix, Cartão e Boleto
  • Transações recentes — Últimas cobranças com status

Se sua conta ainda não foi aprovada pelo processador, um banner aparece no topo com as etapas pendentes:

  1. Documentos — Envie selfie e documento de identificação pelo link fornecido
  2. Dados comerciais — Validação automática pela Receita Federal
  3. Aprovação geral — Análise da equipe de compliance

O banner desaparece automaticamente quando sua conta é ativada.


3. Transações

Lista todas as cobranças da sua organização com filtros:

  • Status: Pendente, Confirmado, Recebido, Vencido, Reembolsado, Chargeback
  • Tipo: Pix, Cartão, Boleto
  • Data: De / Até

Ações disponíveis

  • Clicar na transação → Modal com detalhes completos (valores, taxas, dados Pix/boleto)
  • Reembolsar → Reembolso parcial ou total (requer PIN)
  • Cancelar → Cancela cobranças pendentes
  • Dossiê de defesa → Gera relatório completo com evidências para contestar chargebacks

4. Assinaturas

Gerencie assinaturas recorrentes vinculando clientes a planos.

  • Nova assinatura → Selecione cliente, plano e método de pagamento
  • Cancelar → Interrompe a recorrência

5. Planos

Defina os planos que seus clientes podem assinar.

  • Nome, preço, ciclo (semanal, mensal, trimestral, anual, etc.)
  • Ativo/Inativo — Desative sem excluir
  • Features — Tags descritivas do que o plano inclui

6. Produtos

Para vendas avulsas (não recorrentes):

  • Pagamento único — Um produto, um pagamento
  • Pacote — N unidades por um preço (ex: 5 eventos por R$ 1.297)
  • Créditos — Saldo consumível

7. Pedidos

Cada venda de produto gera um pedido com ciclo de vida:

Pendente → Pago → Entregue

  • Pedidos são marcados como Pago automaticamente via webhook quando o pagamento é confirmado
  • Use o botão Entregar para marcar como entregue

8. Clientes

Cadastro dos pagadores com:

  • Nome, email, CPF/CNPJ, telefone
  • Endereço (opcional — recomendado para produtos físicos)
  • Sincronizado automaticamente com o processador de pagamentos

9. Antecipação

Receba antes do prazo padrão (D+30 cartão → D+2 útil).

  • Elegíveis — Transações recebidas que podem ser antecipadas
  • Simular — Veja a taxa antes de solicitar
  • Solicitar — Requer PIN de segurança

A antecipação pode ser desabilitada pelo administrador da plataforma.


10. Pix Automático

Cobre seus clientes de forma recorrente via Pix, sem precisar de cartão. O cliente autoriza uma única vez via QR Code no app bancário e a partir daí você gera as cobranças mensais (ou na frequência escolhida) sem nova interação dele.

Disponibilidade: o Pix Automático precisa estar habilitado pelo administrador da plataforma e ativado por você em Configurações → Métodos de pagamento. Sua subconta também precisa estar com a aprovação geral concluída no processador de pagamentos.

Como funciona

  1. Você cria uma autorização informando cliente, frequência (semanal, mensal, trimestral, semestral ou anual) e o valor da primeira cobrança.
  2. A Vitrin gera um QR Code de aceite que você compartilha com o cliente.
  3. O cliente escaneia no app bancário e autoriza a primeira cobrança + as recorrências.
  4. A autorização passa de Aguardando aceite para Ativa.
  5. Você gera cada cobrança recorrente em Nova cobrança dentro da autorização. Cada cobrança precisa respeitar o prazo do Banco Central: vencimento entre 2 e 10 dias úteis no futuro.
  6. O cliente é debitado automaticamente na data combinada — sem precisar abrir o app.

Criando uma autorização

Pix Automático → Nova autorização

CampoObrigatórioObservação
ClienteSimCliente já cadastrado
Identificador externoSimSeu código de contrato (até 35 caracteres)
FrequênciaSimSemanal / Mensal / Trimestral / Semestral / Anual
InícioSimQuando começa a vigência
TérminoNãoVazio = prazo indeterminado
Valor fixoNãoTrava o valor para todas as cobranças. Vazio = valor variável
DescriçãoNãoAté 35 caracteres
Valor da primeira cobrançaSimCobrança vinculada ao QR Code de aceite

Após criar, a Vitrin mostra o QR Code e o copia-e-cola para você compartilhar com o cliente.

Status da autorização

StatusSignificado
🟡 Aguardando aceiteCliente ainda não escaneou o QR Code
🟢 AtivaCliente aceitou — você pode gerar cobranças
⚪ CanceladaCancelada por você ou pelo cliente
🔴 RecusadaO banco do cliente recusou
⚪ ExpiradaCliente não escaneou no prazo

Gerando cobranças recorrentes

Para autorizações Ativas, clique no ícone + e informe:

  • Valor (bloqueado se a autorização tem valor fixo)
  • Vencimento — entre 2 e 10 dias úteis no futuro
  • Descrição opcional

A cobrança aparece em Transações com tipo Pix Automático. Quando o débito é efetuado, o status muda para Recebido automaticamente via webhook.

Status da cobrança (instrução)

StatusSignificado
AguardandoCriada na Vitrin, ainda não enviada ao SPI
AgendadaAgendada no SPI, aguardando data de débito
ConcluídaPagamento realizado
CanceladaCancelada antes do débito
RecusadaSaldo insuficiente, divergência ou outro motivo

Cancelando uma autorização

Clique no ícone X ao lado da autorização. Requer PIN. Após cancelada, novas cobranças não podem ser geradas, mas as cobranças já agendadas seguem o ciclo normal.

Sincronizar com o processador

Se quiser forçar uma atualização do status (sem aguardar webhook), abra os detalhes da autorização e clique em Sincronizar com Asaas.


11. Transferências

Transfira seu saldo disponível para contas externas.

Saldo

TipoSignificado
DisponívelPronto para saque
A liberarAguardando compensação (D+1 Pix, D+2 Boleto, D+30 Crédito)
TotalDisponível + A liberar

Formas de transferência

  • Pix via chave — CPF, CNPJ, email, telefone ou chave aleatória
  • Dados bancários — Banco, agência, conta (Pix ou TED automático)

Ambas requerem confirmação de dados + PIN de segurança.

Taxa de saque

Uma taxa fixa é cobrada por saque (Pix: R$ 3,49 / TED: R$ 9,49 — padrão). Verifique os valores atuais em Configurações.

Extrato

A aba Extrato mostra todas as movimentações financeiras com saldo corrente.


12. Simulador

Simule valores, taxas e prazos antes de cobrar:

  1. Insira o valor da venda
  2. Escolha o método (Pix, Boleto, Cartão)
  3. Selecione o número de parcelas (cartão)
  4. Ative ou desative o repasse de taxas

O simulador mostra em tempo real:

  • Quanto o cliente paga
  • Quanto você recebe sem antecipação (e quando: D+1, D+2 ou D+30)
  • Quanto você recebe com antecipação (D+2 útil)
  • Comparativo visual em barras

13. Configurações

Métodos de Pagamento

Ative ou desative Pix, Pix Automático, Cartão de Crédito e Boleto conforme sua necessidade. Os métodos disponíveis dependem do que o admin liberou para a sua organização.

Parcelamento

  • Máximo de parcelas — Limite até 21x (dentro do que o admin liberar)
  • Parcela mínima — Valor mínimo de cada parcela

Repasse de Taxas

  • Desligado (padrão): Você absorve as taxas. O cliente paga o valor exato do produto.
  • Ligado: A taxa é somada ao valor cobrado. O cliente paga produto + taxa. Você recebe o valor cheio.

Webhook

Configure a URL onde sua aplicação recebe notificações de eventos (pagamento confirmado, reembolso, chargeback, etc.).

  • URL — Endpoint HTTPS da sua aplicação
  • Secret — Gerado automaticamente, usado para validar assinaturas HMAC-SHA256

Checkout

  • Cor primária — Personalize a cor do checkout

API Key

Regenere sua API key (a anterior é revogada). Requer PIN.


14. Segurança

PIN de 6 dígitos

Operações sensíveis requerem PIN:

AçãoRequer PIN
Reembolsar transaçãoSim
Solicitar antecipaçãoSim
Cancelar autorização Pix AutomáticoSim
Transferir saldoSim
Alterar webhookSim
Regenerar API keySim
Alterar métodos de pagamentoSim
Criar cobrançaNão
Criar autorização Pix AutomáticoNão
Gerar cobrança recorrente Pix AutomáticoNão
Visualizar relatóriosNão

Bloqueio de PIN

Após 5 tentativas erradas, o PIN é bloqueado por 15 minutos.

Redefinir PIN

Acesse a tela de login → "Esqueci meu PIN" → Confirme com email e senha → Novo PIN via email.


15. Chargebacks

Se um cliente contestar uma cobrança (chargeback), a Vitrin:

  1. Recebe o evento do processador
  2. Atualiza o status da transação para chargeback
  3. Repassa o evento para o seu webhook
  4. Disponibiliza o Dossiê de Defesa com todas as evidências

Dossiê de Defesa

Acesse qualquer transação → clique → "Dossiê de defesa". O relatório inclui:

  • Dados do pagador (CPF, email, telefone, IP, endereço)
  • Detalhes da transação (valor, data, método)
  • Comprovante de entrega (se o pedido foi marcado como entregue)
  • Transações anteriores do mesmo cliente (não contestadas)
  • Timeline de webhooks
  • Registro de auditoria

Use essas informações para montar sua defesa junto ao processador.


16. Suporte