AppShell responsivo
Sidebar no desktop e navegação inferior com quatro ações primárias e menu “Mais” no mobile.
DesignReferência vigente · verificada em 26 ago. 2026
Como a VendePay funciona hoje.
Esta é a leitura canônica para produto, design, engenharia e agentes de IA. Ela separa o comportamento em execução dos protótipos históricos preservados no hub.
01
Fundamentos atuais
Marca e linguagem permanecem estáveis. Os valores abaixo refletem os tokens executados nos frontends.
PapelClaroEscuro
Brand
#04D361#0BF372Accent
#049366#0BF372Background
#F8F9FA#070707Surface
#FFFFFF#101010Texto primário
#212529#E1E1E6Texto terciário
#667085#8A8A96Borda
#E6E9EF#29292EPoppinsTítulos, KPIs e valores monetários.
Open SansCorpo, rótulos, campos e ajuda.
Escala de 8px4, 8, 12, 16, 24, 32, 48 e 64px.
Raios8px pequeno, 10px controle, 12px card, 16px grande e pill.
AcessibilidadeCor, ícone e texto juntos; foco visível; alvo de toque mínimo de 44px.
02
Padrões compartilhados
Reutilize os componentes do design system implementado antes de criar estilos ou variações locais.
FocusEditor
Jornadas densas ocupam uma camada de foco e restauram o contexto anterior ao sair.
Drawer adaptativo
Painel lateral no desktop e superfície de largura total no mobile.
Feedback completo
Skeleton com a forma do conteúdo, vazio com orientação e CTA, erro com recuperação, toast e banner acionável.
03
Produto, preço e funil
A experiência corrente é mais direta e tem invariantes explícitas no contrato.
Uma oferta e um plano principais
- A V1 aceita uma oferta principal e um plano principal por produto.
- Uma segunda criação ou identificador diferente recebe conflito 409.
- Preço mínimo equivalente a 10 na moeda base.
- Descritor de fatura é obrigatório.
Etapas vigentes
Básico, Recursos, Preço, Funil, Afiliados e Links. Recorrência vive em Preço; o builder abre por Links.
Tracking é uma etapa própria com Meta, TikTok, Google Ads e UTMify.
Árvore de conversão
Múltiplos order bumps, ramos de aceite/recusa, upsell e downsell, páginas hospedadas ou externas e planos recorrentes.
Comissão e coprodução fazem parte das regras da jornada.
04
Checkout Builder
Não modele campanhas como checkouts independentes. O modelo mental atual é único por produto.
Controles atuais
Modelo visual, cor, banner, campos, URL de obrigado, e-mail obrigatório, wallets, sessão, recuperação, cupom e páginas externas de funil.
Câmbio dinâmico
O vendedor define um preço base. A plataforma converte dinamicamente; não existe cadastro manual de preço por moeda.
A prévia de idioma cobre 12 idiomas.
Capacidade ≠ disponibilidade
O checkout pode suportar meios adicionais conforme runtime e adquirente. No painel atual, cartão e wallets aparecem ativos; PIX e boleto podem aparecer como “em breve”.
Dívida técnica conhecida: contratos internos ainda preservam checkouts[] e endpoint de criação por compatibilidade. Isso não autoriza uma experiência de múltiplos checkouts.
05
Saldos e saque
A interface é única e neutra em relação a provedores. Nomes internos nunca aparecem para o vendedor.
Separação por moeda
O valor de destaque é sempre Disponível. Mostre também A liberar, Reservado e Em envio, com moeda explícita.
Gates antes do envio
KYC, dívidas e outro saque aberto podem bloquear a solicitação. Explique causa e próximo passo.
Transparência antes de confirmar
Spread de 2%, IOF de 3,5% somente quando o destino é BRL e tarifa fixa equivalente a R$ 4,99.
06
Entrada e KYC
O fluxo atual centraliza pessoa física, jurídica, PEP e documentos em uma mesma jornada.
Autenticação atual
Login por e-mail e senha, recuperação/redefinição e verificação de e-mail. Não prometa login com Google sem implementação correspondente.
KYC condiciona a operação
Validação incompleta pode bloquear tanto a venda quanto o saque. Cadastro pode antecipar destino PIX ou cripto na rede Base.
07
Status e jornada de vendas
Os seis enums abaixo são a base. A interface também deriva situações compostas sem inventar novos contratos.
EnumRótuloFamília
PENDINGPendenteAguardandoPAIDPagaSucessoFAILEDRecusadaEncerradoREFUND_REQUESTEDAguardando reembolsoAguardandoREFUNDEDEstornoInformativoCHARGED_BACKChargebackEncerradoApresentações derivadas observadas: Reembolso parcial, Reembolso de chargeback, Disputa ganha, Assinatura encerrada e Situação mista. Sempre comunique estado, causa e próximo passo.
08
Operação atual
O produto cresceu além das telas do primeiro handoff.
Visão gerencial
Seis KPIs, filtros de período, visão e moeda, recorrência, pagamentos, origem, estado, premiações e indicação de atualização dos dados.
Jornadas agrupadas
Cobranças por jornada, reembolso total ou parcial por cobrança, chargeback evitado/disputa ganha, retentativas, dunning, trial e cancelamento ao fim do período.
Áreas adicionais
Coproduções, Configurações e Webhooks complementam produtos, afiliados, vendas, assinaturas e finanças.
Painel administrativo separado
Dashboard, Vendas, Finanças, Assinaturas, Produtos, Alertas, Chargebacks, Reconciliação, Contabilidade, Saques, Usuários, Adquirentes, Equipe e Configurações/Webhooks.
09
O que mudou desde o snapshot
Use esta tabela como proteção contra decisões antigas que ainda aparecem nos protótipos de junho de 2026.
ÁreaNo snapshotHoje
Checkout BuilderVários checkouts e campanhasUm Checkout principal e um Estilo principal por produto
Saldos e saqueTrês experiências coexistentesUm saque manual/sob demanda; PIX e cripto são destinos
Mercado globalPreço definido por moedaConversão dinâmica a partir do preço base
ProdutoEtapas dinâmicas antigasUma oferta e um plano principais; tracking e links reorganizados
KYCOnboarding antigo em quatro passosJornada unificada PF/PJ/PEP que condiciona vender e sacar
StatusRótulos e estados antigosSeis enums base, com Estorno para REFUNDED e estados derivados
Rastreabilidade
Verificação ponta a ponta
Conferido em 26/08/2026 contra core/checkout, painel do vendedor, painel de gestão e navegação real do ambiente de homologação. Mudanças futuras devem atualizar esta página e os endpoints para IA no mesmo ciclo.