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
Banner de Onboarding
Se sua conta ainda não foi aprovada pelo processador, um banner aparece no topo com as etapas pendentes:
- Documentos — Envie selfie e documento de identificação pelo link fornecido
- Dados comerciais — Validação automática pela Receita Federal
- 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
- Você cria uma autorização informando cliente, frequência (semanal, mensal, trimestral, semestral ou anual) e o valor da primeira cobrança.
- A Vitrin gera um QR Code de aceite que você compartilha com o cliente.
- O cliente escaneia no app bancário e autoriza a primeira cobrança + as recorrências.
- A autorização passa de Aguardando aceite para Ativa.
- 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.
- O cliente é debitado automaticamente na data combinada — sem precisar abrir o app.
Criando uma autorização
Pix Automático → Nova autorização
| Campo | Obrigatório | Observação |
|---|---|---|
| Cliente | Sim | Cliente já cadastrado |
| Identificador externo | Sim | Seu código de contrato (até 35 caracteres) |
| Frequência | Sim | Semanal / Mensal / Trimestral / Semestral / Anual |
| Início | Sim | Quando começa a vigência |
| Término | Não | Vazio = prazo indeterminado |
| Valor fixo | Não | Trava o valor para todas as cobranças. Vazio = valor variável |
| Descrição | Não | Até 35 caracteres |
| Valor da primeira cobrança | Sim | Cobranç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
| Status | Significado |
|---|---|
| 🟡 Aguardando aceite | Cliente ainda não escaneou o QR Code |
| 🟢 Ativa | Cliente aceitou — você pode gerar cobranças |
| ⚪ Cancelada | Cancelada por você ou pelo cliente |
| 🔴 Recusada | O banco do cliente recusou |
| ⚪ Expirada | Cliente 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)
| Status | Significado |
|---|---|
| Aguardando | Criada na Vitrin, ainda não enviada ao SPI |
| Agendada | Agendada no SPI, aguardando data de débito |
| Concluída | Pagamento realizado |
| Cancelada | Cancelada antes do débito |
| Recusada | Saldo 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
| Tipo | Significado |
|---|---|
| Disponível | Pronto para saque |
| A liberar | Aguardando compensação (D+1 Pix, D+2 Boleto, D+30 Crédito) |
| Total | Disponí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:
- Insira o valor da venda
- Escolha o método (Pix, Boleto, Cartão)
- Selecione o número de parcelas (cartão)
- 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ção | Requer PIN |
|---|---|
| Reembolsar transação | Sim |
| Solicitar antecipação | Sim |
| Cancelar autorização Pix Automático | Sim |
| Transferir saldo | Sim |
| Alterar webhook | Sim |
| Regenerar API key | Sim |
| Alterar métodos de pagamento | Sim |
| Criar cobrança | Não |
| Criar autorização Pix Automático | Não |
| Gerar cobrança recorrente Pix Automático | Não |
| Visualizar relatórios | Nã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:
- Recebe o evento do processador
- Atualiza o status da transação para
chargeback - Repassa o evento para o seu webhook
- 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
- Dashboard: https://vitrin.digital/dashboard
- Email: contato@vitrin.digital