Pular para o conteúdo
Manual Visual
CAP. 01 Identidade da Marca
BuscarCtrlK

Manual de Identidade Visual

A fonte única da verdade para tudo que leva a marca PoisonPay: da cor de um botão ao texto de um e-mail de cobrança. Se não está aqui, não é PoisonPay.

Venom Dark Theme 34 capítulos Gateway de Pagamentos Tokens em CSS
Capítulo 01

Identidade da Marca

A PoisonPay é infraestrutura financeira. A marca precisa transmitir três coisas ao mesmo tempo: potência, segurança e modernidade. Nada aqui é decorativo — cada elemento carrega um desses significados.

1.1 · O logotipo

O logotipo é composto por dois elementos que podem viver juntos ou separados, mas nunca ser redesenhados.

O símbolo

Um P construído com corte diagonal, sugerindo velocidade e transação em movimento. No centro do contorno vive um cadeado — a promessa de segurança não é dita, é desenhada. O símbolo sozinho é o avatar, o favicon e o app icon.

O logotipo textual

"Poison" em degradê branco→lavanda, "Pay" em degradê magenta→azul. A divisão cromática separa identidade de função. Sempre em caixa alta e baixa como no original — nunca em versalete, nunca todo maiúsculo.

1.2 · Versões oficiais

PoisonPay — versão principal
Principal · fundo escuro

Uso padrão. Headers, dashboards, checkout, e-mails.

PoisonPay — símbolo
Símbolo isolado

Favicon, app icon, avatar, selo de rodapé.

PoisonPay — monocromático branco
Monocromático branco

Sobre a cor de marca, fotos ou impressão em 1 cor.

PoisonPay — versão sobre fundo claro
Fundo claro

Exceção: nota fiscal, contrato, documento impresso.

1.3 · Atributos da marca

Rápido

Liquidação em D+0. A interface nunca faz o usuário esperar sem feedback.

Seguro

Antifraude e PCI. Segurança é visível na UI, não escondida no rodapé.

Transparente

Taxa, prazo e saldo sempre à vista. Nunca letra miúda.

Premium

Dark theme, degradês e glow. Parece caro porque é bem feito.

Capítulo 02

Paleta de Cores

A paleta nasce do degradê do logotipo: magenta → roxo → azul elétrico, ancorada em roxo escuro e azul mar. É uma paleta exclusivamente dark — não existe versão light da PoisonPay.

2.1 · Cores de marca

Roxo Poison
#7B2CFA
Primária. Botões, links, foco, estados ativos.
Poison Magenta
#E700FF
Acento. Topo do degradê, glow, destaque pontual.
Violeta Neon
#A81CFF
Hover, anel de foco, ícones de destaque.
Azul Elétrico
#3D1AF5
Base fria do degradê, gráficos, dados.
Roxo Escuro
#2A0B6B
Profundidade, fundos de seção em destaque.
Azul Mar
#0B2545
Superfície fria. Áreas de leitura longa e relatórios.

2.2 · Escalas completas

Roxo (primária)

50F4EDFF
100E5D5FF
200CBABFF
300B081FF
4009556FF
5007B2CFA
6006318E0
7004D11B4
800380C87
90026085C

Magenta (acento)

50FDE8FF
100FAC8FF
200F591FF
300F059FF
400EB2CFF
500E700FF
600BC00D1
7009000A1
800650071
9003D0044

Azul elétrico (secundária)

50EBE9FF
100D0CAFF
200A99DFF
3008170FF
4005E43FF
5003D1AF5
6003010D1
700240BA3
800190776
900100450

Azul mar (superfícies frias)

50E7F0FA
100C4DAF0
2008FB4DD
3005A8CC7
4002F65A6
5001B4079
600143260
7000E2549
8000B2545
900061224

2.3 · Degradês oficiais

O degradê de marca reproduz exatamente o logotipo. Não crie variações novas.

--pp-grad-brand

O degradê do logotipo. Botão primário, cartão, header de e-mail.

--pp-grad-venom

Versão curta e mais quente. Barras de progresso, toggles, badges.

--pp-grad-sea

Azul mar. Áreas informativas e blocos de dados.

--pp-grad-abyss

Fundo profundo. Páginas de erro e estados vazios.

2.4 · Superfícies do dark theme

Cinco níveis de elevação. Quanto mais alto o elemento, mais clara a superfície — a hierarquia vem da luz, não da sombra.

Base
#07050F
Fundo da página
Elevação 1
#0C0918
Sidebar, superfície base
Elevação 2
#131024
Cards, inputs
Elevação 3
#1B1633
Hover, cabeçalho de tabela
Elevação 4
#241E44
Popover, pressionado
Superfície Mar
#0A1B33
Variante fria

2.5 · Cores de status financeiro

Vocabulário fechado. Toda transação no ecossistema PoisonPay usa exatamente um destes sete estados — em qualquer tela, e-mail ou webhook.

Pago Pendente Estornado Recusado Em análise Chargeback Bloqueado
EstadoCorQuando usar
Pago#00E5A0Valor confirmado e disponível para saque conforme o prazo.
Pendente#FFB020Aguardando pagamento do cliente (PIX gerado, boleto emitido).
Estornado#35C6FFDevolução concluída, a pedido do seller ou do cliente.
Recusado#FF3D6ENegado pelo emissor ou pelo antifraude. É um fim de fluxo.
Em análise#A81CFFRetido pelo antifraude, aguardando decisão manual.
Chargeback#FF7A3DContestação aberta pelo portador junto ao emissor.
Bloqueado#7E7898Conta ou transação travada por decisão de compliance.

2.6 · Regras de aplicação

Um acento por tela

O magenta é pontuação, não parágrafo. Use no elemento mais importante e em mais nada.

Degradê em texto corrido

Degradê só em títulos curtos e números. Em parágrafo, destrói a legibilidade.

Cor de status vem da tabela

Verde é sempre "pago". Nunca use verde para "salvar" ou "concluir" um formulário.

Cinza neutro

Nossos escuros têm base arroxeada. Cinza puro (#2A2A2A) parece um bug ao lado da paleta.

Capítulo 03

Tipografia

Duas famílias, zero exceções. Uma para interface, uma para números e código.

Plus Jakarta Sans

Aa Bb Cc 123

Família de interface. Geométrica e levemente arredondada — conversa com as curvas do logotipo sem competir com ele. Excelente em corpo pequeno sobre fundo escuro.

Pesos: 400 · 500 · 600 · 700 · 800

JetBrains Mono

R$ 1.482,90

Família monoespaçada. Obrigatória para valores monetários, IDs de transação, chaves PIX, códigos e JSON. O alinhamento vertical dos dígitos é o que torna uma tabela financeira legível.

Pesos: 400 · 600 · 700

3.1 · Escala tipográfica

DisplayPagamentos60/68 · 800
H1Painel do seller40/48 · 800
H2Transações recentes30/38 · 800
H3Resumo financeiro24/32 · 700
H4Dados da cobrança20/28 · 600
H5Forma de pagamento18/24 · 600
Body LGTexto de apoio em destaque, usado em introduções.17/26 · 400
BodyCorpo padrão de leitura em toda a interface.16/24 · 400
Body SMTexto secundário, descrições e células de tabela.14/20 · 400
CaptionLegendas, timestamps e textos auxiliares.12/16 · 400
LabelRótulo de seção11.5/14 · 700
Monotxn_9f3a71c4e2 · R$ 247,9014/20 · 400

3.2 · Regras de uso

Valores sempre em mono

R$, percentuais, IDs e datas em JetBrains Mono. Colunas ficam alinhadas e comparáveis.

Mais de 3 pesos por tela

Regular, SemiBold e ExtraBold resolvem tudo. Mais que isso vira ruído.

Máximo 75 caracteres por linha

Em textos longos, limite a largura. Linha longa em dark theme cansa o dobro.

Texto puro branco em parágrafo

#FFFFFF só em títulos. Corpo usa #C6BFDE para reduzir o brilho no escuro.

Capítulo 04

Grid, Espaço e Raio

Grid de 12 colunas, espaçamento em múltiplos de 4px e uma escala fixa de raios.

4.1 · Grid de 12 colunas

1
2
3
4
5
6
7
8
9
10
11
12
span 6 · conteúdo principal
span 3
span 3
span 8 · tabela
span 4 · sidebar

4.2 · Escala de espaçamento

Base 4px. Nunca use um valor fora da escala — se precisou de 13px, o layout está errado.

4
8
12
16
20
24
32
40
48
64
80

4.3 · Raios de borda

4xs · tag
6sm · chip
10md · botão, input
14lg · cartão
16card
20xl · plano
22modal
pill

4.4 · Breakpoints

NomeLarguraComportamento
sm640pxUma coluna. Bottom nav assume a navegação.
md768pxDuas colunas em cards. Tabela vira scroll horizontal.
lg1024pxSidebar fixa aparece. Layout completo de dashboard.
xl1280pxGrid de 3–4 colunas em KPIs.
2xl1536pxConteúdo trava em 1120px e centraliza.
Capítulo 05

Design Tokens

Todo valor do sistema existe como custom property CSS. Código de produto consome o token, nunca o valor bruto — trocar a marca inteira deve ser uma edição em um arquivo.

Importar no projeto
<link rel="stylesheet" href="https://poisonpay.com.br/id-visual/assets/css/tokens.css">

5.1 · Tokens de cor

--pp-purple      #7B2CFA   /* primária          */
--pp-magenta     #E700FF   /* acento            */
--pp-violet      #A81CFF   /* hover / foco      */
--pp-blue        #3D1AF5   /* secundária        */
--pp-deep        #2A0B6B   /* roxo escuro       */
--pp-sea         #0B2545   /* azul mar          */

--pp-bg-base     #07050F   /* fundo da página   */
--pp-bg-elev-2   #131024   /* cards e inputs    */

--pp-text-high   #FFFFFF   /* títulos           */
--pp-text-med    #C6BFDE   /* corpo             */
--pp-text-low    #9089AD   /* secundário        */

5.2 · Movimento

Durações

  • --pp-dur-instant 80ms — feedback de toque
  • --pp-dur-fast 140ms — hover, foco
  • --pp-dur-base 220ms — padrão
  • --pp-dur-slow 340ms — modal, drawer
  • --pp-dur-slower 520ms — reveal

Curvas

  • standard — 90% dos casos
  • emphasized — entrada de painéis
  • spring — toggles e checks
  • in — saídas
  • out — entradas suaves

Z-index

  • dropdown 1000
  • sticky 1100
  • overlay 1200
  • modal 1300
  • toast 1500 · tooltip 1600

5.3 · Elevação

elev-1

Divisores, linhas

elev-2

Cards

elev-3

Dropdowns

elev-4

Modais

Capítulo 06

Uso da Marca

O logotipo é o ativo mais caro da empresa. Estas regras não são estéticas — são de proteção.

6.1 · Área de respiro

A margem mínima ao redor do logotipo equivale à altura do cadeado do símbolo (referido como X). Nenhum elemento — texto, borda, imagem — invade essa área.

margem mínima = 1X em todos os lados
Demonstração de área de respiro

6.2 · Tamanhos mínimos

200px · header web
120px · mínimo digital
40px · símbolo mínimo
24px · favicon

Impresso: logotipo completo com no mínimo 25mm de largura; símbolo isolado com no mínimo 8mm. Abaixo disso o cadeado fecha visualmente e a marca perde o significado.

6.3 · Usos proibidos

Seis formas de destruir a marca. Nenhuma delas é aceitável em nenhum contexto.

Não Logotipo distorcido

Distorcer ou esticar. Sempre redimensione proporcionalmente.

Não Logotipo rotacionado

Rotacionar. O logotipo vive sempre na horizontal.

Não Logotipo com cores alteradas

Recolorir. O degradê é fixo; a única variante é o branco monocromático.

Não Logotipo com sombra dura

Aplicar sombra, contorno ou relevo. Use apenas o glow definido no sistema.

Não Logotipo sobre fundo poluído

Fundo poluído. Sobre foto, use a versão monocromática com camada escura.

Não Logotipo com baixo contraste

Baixo contraste. Fundo médio apaga o degradê — use escuro ou muito claro.

Capítulo 07

Iconografia

Font Awesome 6.5.1, estilo solid como padrão. Emoji é proibido em qualquer interface, e-mail ou notificação da PoisonPay.

CDN oficial
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">

7.1 · Ícones financeiros

credit-card
qrcode
barcode
wallet
money-bill-transfer
receipt
arrow-trend-up
hand-holding-dollar
percent
building-columns

7.2 · Status e feedback

circle-check
clock
circle-xmark
rotate-left
triangle-exclamation
ban
circle-info
shield-halved

7.3 · Interface e navegação

gauge-high
user
gear
bell
magnifying-glass
filter
download
plug
code
ellipsis

7.4 · Regras

Tamanhos da escala

12 · 14 · 16 · 20 · 24px. Ícone acompanha o tamanho do texto ao lado.

Misturar estilos

Não use regular e solid na mesma tela. Solid é o padrão.

Ícone sozinho precisa de rótulo

Botão só com ícone exige aria-label e, de preferência, tooltip.

Emoji

Renderiza diferente em cada sistema e quebra o tom profissional de um gateway.

Capítulo 08

Botões

Um botão primário por tela. Ele é a ação que você quer que o usuário tome — se há dois, não há nenhum.

8.1 · Variantes

VarianteQuando usar
PrimárioA ação principal da tela: pagar, criar cobrança, sacar.
SecundárioAlternativa relevante ao lado da principal: "Ver detalhes".
GhostAções de baixa hierarquia: filtros, exportar, cancelar.
LinkNavegação inline dentro de um texto ou card.
SucessoConfirmação de valor liberado. Raro — não use como "salvar".
PerigoDestrutivo e irreversível: estornar, excluir chave, bloquear.

8.2 · Tamanhos

8.3 · Com ícone, somente ícone e largura total

Com ícone

Somente ícone

Grupo

Largura total

Padrão em checkout mobile e cards de autenticação.

Estados

Toda ação que chama a API entra em loading imediatamente. O usuário nunca deve conseguir clicar duas vezes em "Pagar".

Capítulo 09

Formulários

Em um gateway, formulário é onde o dinheiro entra. Rótulo sempre visível, erro sempre explicado, e nunca placeholder no lugar de label.

9.1 · Campos base

Usado para validação junto à Receita Federal.
0 / 300

Prefixo e sufixo

R$
%

Estados de validação

Chave verificada no DICT.
CPF inválido. Confira os dígitos verificadores.

9.2 · Seleção

Checkboxes

Radios

Toggles

9.3 · Código de verificação

Digite o código enviado

Enviamos 6 dígitos para +55 (47) ••••-3391

Cole o código completo — os campos preenchem sozinhos.

Capítulo 10

Badges, Chips & Status

Badge informa, chip filtra. Não troque os papéis.

10.1 · Badges semânticos

PoisonPay Beta Rascunho Ativo Atenção Informação Crítico

Status de transação

Pago Pendente Estornado Recusado Em análise Chargeback Bloqueado

10.2 · Chips de filtro

Filtros aplicados a uma listagem. Clique no X para remover.

PIX Pago Últimos 30 dias Acima de R$ 500 Loja Centro

10.3 · Indicadores de presença

Online Ausente Ocupado Offline
Capítulo 11

Alertas & Banners

Alerta inline fica no contexto do problema. Banner fala com a conta inteira.

11.1 · Alertas inline

Pagamento confirmado
R$ 247,90 creditados no seu saldo. Disponível para saque em D+1.
Verificação pendente
Envie o comprovante de endereço para liberar saques acima de R$ 5.000. Enviar agora
Webhook falhando
7 tentativas sem resposta em https://loja.com/hooks/pp. Após 24h o endpoint é desativado.
Antecipação disponível
Você tem R$ 12.480,00 a receber. Antecipe por 1,99% ao mês.

11.2 · Banners de topo

Split de pagamento chegou. Divida o valor entre até 10 recebedores automaticamente.
Manutenção programada no dia 24/08, das 02h às 04h. A API de cobrança segue disponível.
Você está em modo sandbox. Nenhuma transação é real.

11.3 · Consentimento LGPD

Capítulo 12

Avatares

Sem foto, usamos iniciais sobre o degradê de marca. Nunca um ícone genérico de pessoa.

Tamanhos

MR JS AL CF TP PP

Variações de fundo

BR DV GT NX

Com presença

MR JS AL CF

Grupo

MR JS AL CF +12

Usado em times, aprovações e histórico de acesso.

Capítulo 13

Loadings & Skeletons

Abaixo de 300ms, não mostre nada. Acima de 300ms, skeleton. Acima de 3s, mensagem explicando o que está acontecendo — em pagamento, silêncio é ansiedade.

Spinners

Dots

Inline, dentro de texto

Pulse

Aguardando PIX

Em botão

13.1 · Skeleton screens

O skeleton imita a forma do conteúdo que vai chegar. Isso reduz a percepção de espera e evita salto de layout.

Capítulo 14

Progresso & Steps

Barras para quantidade, stepper para jornada.

14.1 · Barras

Meta de faturamento mensal82%
Taxa de aprovação94,2%
Limite de volume utilizado68%
Sincronizando transaçõesem curso

14.2 · Progresso circular

94%aprovação
71%conversão
38%cadastro
100%KYC

14.3 · Stepper

Conta criada
Dados da empresa
3
Documentos
4
Conta bancária
5
Aprovado
Capítulo 15

Tabelas

A tabela de transações é a tela mais usada do produto. Valores alinhados à direita em fonte mono, status como badge, e ações sempre na última coluna.

Últimos 7 dias Todos os métodos
Transação Cliente Método Valor Status Data Ações
txn_9f3a71c4e2
MRMarina Rocha
PIX R$ 247,90 Pago 17/08 14:32
txn_4c81de5b90
JSJoão Silveira
Crédito 3x R$ 1.480,00 Em análise 17/08 13:07
txn_2b70ff13ac
ALAna Lemos
Boleto R$ 89,90 Pendente 17/08 11:44
txn_8e15a09d33
CFCarlos Ferraz
Crédito R$ 3.299,00 Recusado 17/08 10:19
txn_6a92cc47f1
TPThiago Prado
PIX R$ 512,40 Estornado 16/08 19:51
txn_1d38b6e70a
RNRenata Nunes
Crédito 12x R$ 7.850,00 Chargeback 16/08 16:03
Exibindo 6 de 1.284 transações
Capítulo 16

Acordeão

Para FAQ e conteúdo longo opcional. Nunca esconda informação obrigatória atrás de um acordeão.

PIX liquida em D+0 — o valor entra no saldo em segundos. Cartão de crédito liquida em D+30 no plano padrão, ou D+2 com antecipação automática. Boleto liquida em até 3 dias úteis após a compensação.
Você define os recebedores e os percentuais na criação da cobrança. A PoisonPay divide o valor automaticamente no momento da liquidação, com até 10 recebedores por transação. Cada um recebe o extrato individual.
O valor é bloqueado do saldo e você recebe uma notificação com prazo de 7 dias para enviar a defesa. Anexe comprovante de entrega, aceite de termos e histórico de contato. Se a defesa for aceita, o valor retorna integralmente.
PIX: 0,99% por transação. Cartão de crédito à vista: 3,99%. Parcelado: 4,99% + 2,49% ao mês. Boleto: R$ 3,49 fixo por boleto pago. Sem mensalidade, sem taxa de adesão e sem cobrança por boleto não pago.
Capítulo 17

Cards Especiais

Três formatos com função definida: KPI mede, plano vende, status resume.

17.1 · KPI

Faturamento hoje
R$ 48.291
18,4%vs. ontem
Transações
1.284
7,1%últimas 24h
Taxa de aprovação
94,2%
1,3ppmédia do setor: 87%
Carrinhos abandonados
312
4,6%R$ 27.104 em aberto

17.2 · Planos

Starter
R$0/mês

Para quem está começando a vender.

  • PIX a 1,49% por transação
  • Cartão a 4,49% à vista
  • Checkout transparente
  • Suporte por e-mail
  • Split de pagamento
  • Gerente de conta
Enterprise
Sob consulta

Volume acima de R$ 1M/mês.

  • Taxas negociadas
  • SLA contratual de 99,99%
  • Checkout white-label
  • Ambiente dedicado
  • Gerente de conta exclusivo
  • Integração assistida

17.3 · Cards de status

Pagamento aprovado
PIX · Marina Rocha · há 2 minutos
R$ 247,90
Aguardando pagamento
PIX gerado · expira em 24 minutos
R$ 89,90
Estorno processado
Solicitado pelo seller · 16/08 19:51
R$ 512,40
Transação recusada
Saldo insuficiente no emissor · código 51
R$ 3.299,00
Capítulo 18

Modais, Toasts & Snackbars

Modal interrompe e exige decisão. Toast informa sem interromper. Snackbar confirma e oferece desfazer. Clique nos botões — todos os exemplos são reais.

Modais

Loading global

Toasts

Snackbars

18.1 · Quando usar cada um

ComponenteInterrompe?Usar quando
ModalSimA decisão é irreversível ou bloqueia o fluxo: estornar, excluir chave de API, aceitar termos.
ToastNãoEvento assíncrono chegou: pagamento aprovado, webhook falhou, saque liberado.
SnackbarNãoConfirmação de uma ação do próprio usuário, com opção de desfazer.
Alerta inlineNãoO problema pertence a uma área específica da tela e continua enquanto não for resolvido.
Capítulo 20

Checkout & Pagamentos

É aqui que a conversão acontece. Cada elemento tem uma regra: o valor é o maior texto da tela, o botão de pagar nunca sai da dobra, e o cliente sempre sabe quanto falta pra expirar.

20.1 · Display de valor

Total a pagar
R$247,90

Sempre com separador de milhar e duas casas. Os centavos são menores para dar peso ao inteiro.

Métodos disponíveis
PIX
Aprovação imediata
Crédito
Até 12x
Boleto
1 a 3 dias úteis
Saldo
Instantâneo

20.2 · Cartão de crédito

•••• •••• •••• 4291
Titular
Marina R Souza
Validade
09/29

Resumo do pedido

Assinatura Pro · mensalR$ 149,00
Taxa de processamentoR$ 5,94
Desconto PRIMEIROMES− R$ 30,00
TotalR$ 124,94

Ambiente seguro · dados criptografados · PCI DSS nível 1

20.3 · PIX com QR Code e expiração

25:00

Abra o app do seu banco e escaneie o código.

00020126580014BR.GOV.BCB.PIX0136c4e2a71f-9f3a-4b8d-a10c-7e5290bd11f45204000053039865802BR5910POISONPAY6009SAO PAULO62070503***6304A1B2

Linha do tempo do pedido

Pedido criado
17/08 · 14:28:04
Cobrança PIX gerada
17/08 · 14:28:06
Aguardando pagamento
expira 17/08 · 14:53:06
Pagamento confirmado
Valor liquidado no saldo
Capítulo 21

Dashboard

A primeira tela após o login responde três perguntas em menos de dois segundos: quanto eu tenho, quanto vou receber e o que precisa da minha atenção.

Saldo disponível
R$ 84.219
A receber
R$ 312.740
próximos 30 dias
Conversão do checkout
71,4%
3,2ppvs. mês anterior
Chargebacks
0,18%
0,04pplimite: 1%

21.1 · Gráfico de volume

Volume transacionado · últimos 7 dias

Aprovado
Seg
Ter
Qua
Qui
Sex
Sáb
Dom

21.2 · Regras do dashboard

Saldo é o primeiro KPI

Sempre no canto superior esquerdo, com a ação de saque ao lado.

Mais de 4 KPIs na dobra

O quinto número já não é lido. Mova o resto para relatórios.

Delta sempre com referência

"+18,4%" sozinho não diz nada. Escreva "vs. ontem".

Gráfico sem eixo nem rótulo

Gráfico decorativo é pior que gráfico nenhum em produto financeiro.

Capítulo 22

API & Webhooks

A API é parte da identidade. Nomes de campo, formato de erro e estrutura de payload seguem um padrão tão rígido quanto a cor de um botão.

22.1 · Endpoints

POST https://api.poisonpay.com.br/v1/charges 201
GET https://api.poisonpay.com.br/v1/charges/{id} 200
PUT https://api.poisonpay.com.br/v1/charges/{id}/refund 200
DELETE https://api.poisonpay.com.br/v1/webhooks/{id} 204

22.2 · Payload de webhook

Evento de pagamento confirmado

{
  "event": "charge.paid",
  "created_at": "2026-08-17T14:32:11Z",
  "data": {
    "id": "txn_9f3a71c4e2",
    "status": "paid",
    "amount": 24790,
    "currency": "BRL",
    "method": "pix",
    "paid_at": "2026-08-17T14:32:09Z",
    "customer": {
      "name": "Marina Rocha",
      "document": "***.456.789-**"
    },
    "fee": 245,
    "net_amount": 24545,
    "livemode": true
  }
}

Formato de erro

{
  "error": {
    "type": "card_declined",
    "code": "insufficient_funds",
    "message": "Saldo insuficiente no cartão.",
    "doc_url": "https://api.poisonpay.com.br/docs/errors#insufficient_funds",
    "request_id": "req_7c1e8a4b02"
  }
}
Regra de ouro dos erros
Todo erro tem type para o código tratar, message em português para o humano ler, e request_id para o suporte rastrear.

22.3 · Integrações nativas

Shopify & WooCommerce
Plugin oficial com checkout transparente.
Ativo
Meta Pixel & CAPI
Envio server-side de eventos de compra.
Ativo
UTMify
Atribuição de origem por transação.
Configurar
Correios & Melhor Envio
Rastreio vinculado ao pedido pago.
Disponível
Capítulo 23

Autenticação & 2FA

A tela de login é a primeira impressão de segurança. Card centralizado, glassmorphism, e 2FA obrigatório para qualquer conta que movimenta dinheiro.

23.1 · Login

Entrar na sua conta

Painel do seller PoisonPay

Esqueci a senha
ou

Ainda não tem conta? Criar conta grátis

23.2 · Verificação em duas etapas

Verificação de segurança

Digite o código do seu app autenticador

Perdeu o acesso? Usar código de recuperação

2FA é obrigatório
Contas sem 2FA não conseguem sacar, alterar conta bancária nem gerar chave de API em produção.
Capítulo 24

Onboarding & KYC

Aprovação de conta é regulatória, mas a experiência não precisa ser burocrática. Mostre sempre em que passo o seller está e o que falta.

Passo 3 de 5 · Documentação

Leva ~4 minutos
Conta
Empresa
3
Documentos
4
Banco
5
Aprovado
Arraste os documentos ou clique para selecionar
RG ou CNH · Contrato social · Comprovante de endereço · PDF, JPG ou PNG até 10 MB
contrato-social.pdf
2,4 MB · verificado
OK
cnh-frente.jpg
enviando · 68%
comprovante-endereco.png
Recusado · documento com mais de 90 dias

24.1 · Checklist de perfil

Complete seu perfil

4 de 6
Capítulo 25

Antifraude & Risco

Score de risco é uma decisão delicada: precisa ser claro sem acusar o cliente. Nunca escreva "fraude" na interface — escreva o que motivou a análise.

25.1 · Score de risco

12risco
Risco baixo · aprovação automática
  • Cliente recorrente · 14 compras anteriores
  • Dispositivo e IP conhecidos
  • Endereço de cobrança confere com a entrega
58risco
Risco médio · revisão manual em até 2h
  • CPF válido e sem restrição
  • Primeiro pedido deste cliente
  • Valor 4x acima do ticket médio da loja
91risco
Risco alto · transação bloqueada
  • 6 tentativas de cartão em 4 minutos
  • IP com histórico de chargeback
  • Geolocalização distante do endereço informado

25.2 · Linguagem em decisões de risco

Escreva assim

"Esta cobrança está em análise de segurança. Você recebe a resposta em até 2 horas e não precisa fazer nada agora."

Nunca assim

"Transação suspeita de fraude detectada. Aguardando validação antifraude."

Escreva assim

"O emissor do cartão não autorizou o pagamento. Tente outro cartão ou pague com PIX."

Nunca assim

"Erro 51 — do not honor. Transação negada."

Capítulo 26

Estados & Erros

Estado vazio sempre oferece uma saída. Página de erro sempre diz o que fazer agora.

26.1 · Estados vazios

Nenhuma transação ainda

Suas vendas aparecem aqui assim que a primeira cobrança for paga.

Nada encontrado

Nenhum resultado para os filtros aplicados. Tente ampliar o período.

Sem conexão

Não conseguimos falar com o servidor. Seus dados estão seguros.

26.2 · Páginas de erro

404
Esta página não existe

O link pode estar quebrado ou a página foi movida.

500
Algo deu errado do nosso lado

Nossa equipe já foi avisada. Nenhuma transação foi perdida.

26.3 · Anatomia de uma boa mensagem de erro

1 · O que aconteceu

Em linguagem humana, sem código de sistema. "O pagamento não foi autorizado."

2 · Por quê

A causa provável, se você souber. "O cartão não tem saldo suficiente."

3 · O que fazer

Sempre uma saída concreta. "Tente outro cartão ou pague com PIX."

Capítulo 27

Templates de E-mail

E-mail é a única superfície da marca em fundo claro — cliente de e-mail não é confiável para dark theme. O header em degradê carrega a identidade.

Confirmação de pagamento

PoisonPay

Pagamento confirmado

Olá, Marina. Recebemos seu pagamento e seu pedido já está em processamento.

R$ 247,90
Pedido#PP-48219
MétodoPIX
Data17/08/2026 às 14:32
LojaStudio Aurora

Ver comprovante

Recuperação de carrinho

PoisonPay

Seu PIX ainda está válido

Olá, João. Você começou uma compra e o código PIX ainda funciona por mais 18 minutos.

R$ 1.480,00
ProdutoCurso Avançado
Expira em17/08/2026 às 14:53

Finalizar pagamento

Se já pagou, ignore este e-mail.

27.1 · Regras para e-mail

Valor em destaque no corpo

O bloco de valor lilás é obrigatório em qualquer e-mail transacional.

Dark theme em e-mail

Outlook e Gmail invertem cores de formas imprevisíveis. Sempre fundo branco.

Um CTA por e-mail

Um botão, uma ação. Links secundários vão em texto no rodapé.

Dados sensíveis completos

Nunca envie CPF, cartão ou chave de API inteiros por e-mail. Sempre mascarados.

Capítulo 28

Notificações & Push

Notifique dinheiro entrando, dinheiro saindo e risco. Nada além disso.

28.1 · Central de notificações

Notificações
Pagamento recebido
R$ 247,90 de Marina Rocha via PIX.
há 2 minutos
Transação em análise
R$ 1.480,00 retidos para revisão manual.
há 1 hora
Saque concluído
R$ 32.000,00 enviados para Banco Inter ••••4821.
ontem · 18:04
Webhook com falha
3 tentativas sem resposta no endpoint principal.
ontem · 09:12

28.2 · Push

PoisonPay
Você recebeu R$ 247,90
PIX de Marina Rocha · já disponível no saldo.
agora
PoisonPay
Saque de R$ 32.000,00 concluído
Enviado para Banco Inter ••••4821.
2h
PoisonPay
Chargeback aberto
R$ 7.850,00 contestados. Você tem 7 dias para responder.
1d
Título de push sempre com o valor
O seller lê a notificação na tela de bloqueio. O valor precisa estar no título, não no corpo.
Capítulo 29

Mobile & Atalhos

Mais de 70% dos pagamentos acontecem no celular. Mobile não é adaptação — é o padrão.

29.1 · Navegação inferior

R$84.219

saldo disponível

Máximo 5 itens. O FAB central é sempre "nova cobrança".

29.2 · Botão de ação flutuante

Um FAB por tela, sempre no canto inferior direito, sempre para a ação mais frequente.

29.3 · Command palette

Pressione Ctrl + K em qualquer lugar do painel. Digite abaixo para filtrar.

ESC
Ações rápidas
Navegar
Capítulo 30

Mídia & Upload

Upload sempre mostra progresso individual e permite remover. Arraste um arquivo na área abaixo para testar.

Área de upload

Solte os arquivos aqui
PNG, JPG, PDF ou CSV até 10 MB

Fila de envio

extrato-agosto.csv
184 KB · concluído
logo-loja.png
1,2 MB · enviando 42%
catalogo-completo.pdf
18,4 MB · excede o limite de 10 MB
Capítulo 31

UX & Engajamento

Gamificação em produto financeiro precisa de mão leve. Reconheça marcos reais do negócio, nunca transforme dinheiro em jogo.

Avaliação

Como foi criar sua primeira cobrança?

NPS

Quanto você recomendaria a PoisonPay?

Nada provávelMuito provável

31.1 · Conquistas do seller

Primeira venda

Você recebeu seu primeiro pagamento

100 transações

Cem pagamentos aprovados

Conta blindada

2FA e KYC completos

R$ 1 milhão

Volume acumulado de 7 dígitos

Zero chargeback

12 meses sem contestação

Capítulo 32

Voz, Tom & Escrita

A PoisonPay fala como um especialista que respeita o tempo de quem lê: direto, sem jargão bancário e sem infantilizar. Somos diretos, humanos e precisos — nunca fofos, nunca burocráticos.

32.1 · Princípios

Direto

Comece pelo mais importante. "R$ 247,90 recebidos" antes de "Temos uma boa notícia para você".

Humano

Escreva como se falasse com o dono da loja. "Você" e "seu dinheiro", não "o usuário" e "os valores".

Preciso

Em dinheiro não existe "em breve". Diga "em até 2 horas" ou "no próximo dia útil".

32.2 · Faça / não faça

Faça

"Seu saque de R$ 32.000,00 cai na conta até as 18h de hoje."

Não faça

"Sua solicitação de resgate foi processada com sucesso e será efetivada conforme o prazo operacional vigente."

Faça

"Não conseguimos gerar o PIX agora. Tente de novo em alguns segundos."

Não faça

"Ops! 😅 Algo deu ruim por aqui, mas já já a gente resolve!"

Faça

"Taxa de 0,99% por transação. Sem mensalidade."

Não faça

"Condições comerciais diferenciadas mediante análise. Consulte termos."

32.3 · Glossário obrigatório

Use sempreNunca usePor quê
CobrançaFatura, boleto (genérico)"Cobrança" cobre PIX, cartão e boleto ao mesmo tempo.
Saldo disponívelSaldo livre, saldo atualDiferencia do que ainda está "a receber".
A receberSaldo futuro, pendente"Pendente" é status de transação, não de saldo.
SacarResgatar, transferirÉ o verbo que o seller usa naturalmente.
RecusadoNegado, falhou, erroPadroniza o vocabulário de status em toda a plataforma.
Em análiseSuspeito, bloqueado por fraudeNão acusa o cliente antes da decisão.

32.4 · Formatação de números

Dinheiro

  • R$ 1.482,90 — ponto no milhar, vírgula nos centavos, espaço após R$
  • − R$ 30,00 — sinal antes do símbolo, com espaço
  • Sempre duas casas decimais, mesmo em valor redondo
  • Na API, sempre em centavos inteiros: 148290

Data, hora e percentual

  • 17/08/2026 às 14:32 — formato brasileiro, 24h
  • 17/08 · 14:32 — versão curta em tabelas
  • 4,99% — vírgula decimal, sem espaço antes do %
  • 3,2pp — variação de percentual usa "pp", não "%"
  • Na API, sempre ISO 8601 em UTC
Capítulo 33

Ecossistema de Domínios

Quatro superfícies, uma identidade. Cada domínio tem um público e um nível de densidade visual diferente — mas todos consomem os mesmos tokens.

poisonpay.com.br
Site institucional

Público: quem ainda não é cliente. Densidade baixa, muito respiro, degradê e glow com força total. É a vitrine da marca.

Marketing Blog Preços
seller.poisonpay.com.br
Painel do seller

Público: o lojista, todos os dias. Densidade média. KPIs, tabelas e saque. É onde o design system trabalha mais.

Dashboard Transações Saques
gestao.poisonpay.com.br
Backoffice interno

Público: time PoisonPay. Densidade alta, pouco ornamento — aqui velocidade de leitura vence estética. Antifraude, compliance e suporte.

Antifraude KYC Suporte
api.poisonpay.com.br
API e documentação

Público: desenvolvedores. A marca aparece na tipografia mono, no realce de sintaxe e na clareza dos erros. Menos glow, mais precisão.

REST Webhooks Sandbox

33.1 · O que é compartilhado

ElementoSiteSellerGestãoAPI
Tokens de cor e tipografiaIdênticos em todos
Componentes do design systemIdênticos em todos
Densidade visualBaixaMédiaAltaMédia
Degradê e glowIntensoModeradoMínimoMínimo
AnimaçãoRicaFuncionalSó feedbackSó feedback
Capítulo 34

Acessibilidade

Meta: WCAG 2.1 nível AA em todas as superfícies. Em um gateway, acessibilidade não é boa vontade — é o direito de conseguir pagar.

34.1 · Contraste

Texto branco sobre fundo base 19,8:1 AAA
Texto de corpo sobre card 10,4:1 AAA
Link roxo 300 sobre card 6,1:1 AA
Texto branco no botão primário 5,3:1 AA
Texto muted — só para conteúdo decorativo 3,1:1 Só decorativo

34.2 · Foco visível

Navegue com Tab pelos elementos abaixo. O anel de foco nunca é removido — nem no checkout.

Link focável

34.3 · Área de toque

44px

Mínimo aceito

26px

Reprovado

Todo alvo tocável tem no mínimo 44 × 44px, mesmo que o ícone visível seja menor. Use padding para atingir a área — não aumente o ícone.

34.4 · Checklist de entrega

Antes de subir qualquer tela

Regras que nunca mudam

  • Cor nunca é o único indicador de estado — sempre acompanha ícone ou texto
  • Nenhum outline: none sem substituto visível
  • Toda imagem informativa tem alt; decorativa tem alt=""
  • Hierarquia de títulos sem pular níveis
  • Tempo de sessão nunca expira durante um pagamento em andamento
  • Animação essencial tem alternativa estática