Modelos de checkout 🎨
Um modelo de checkout define como a sua página hospedada se parece e se
comporta: cores, tipografia, textos, seções, campos que você pede ao cliente,
métodos de pagamento e moedas. Você monta tudo no painel (Dashboard →
Checkout) — sem código — e depois só referencia o modelo pelo slug no
campo checkout do POST /v1/payments.
Pense nele como um "link de pagamento" muito mais editável: cada modelo é multi-método e multi-idioma por padrão.
Onde configurar
No painel, em Checkout Builder, você pode:
- Clonar um preset — a PagNow oferece modelos prontos por vertical (e-commerce, SaaS, games, cassino, doação, eventos, infoproduto, além de um Dark e um Minimal). Clone e ajuste o que quiser.
- Criar do zero — comece com o padrão e edite cada aba.
Cada modelo tem um slug único (ex.: meu-checkout-loja). É esse slug que vai
no campo checkout da API.
O que dá para customizar
O editor é dividido em abas:
Visual
Cores (primária, fundo, cartão, texto, borda, sucesso…), tipografia, cantos (raio), e fundo sólido / gradiente / imagem. Há um campo de CSS personalizado para ajustes finos. O selo "Powered by PagNow" pode ser mostrado ou ocultado.
Textos (por idioma)
Sobrescreva títulos, rótulos e mensagens por idioma. Os idiomas suportados na fase atual são pt-BR, en, es e pt-PT. A página detecta o idioma do navegador do cliente e ainda oferece um seletor de idioma com bandeira.
Layout
Ligue/desligue e reordene as seções da página — resumo do pedido, dados do cliente, métodos, "como funciona", suporte e termos.
Campos & endereço
Escolha quais campos pedir ao cliente (nome, e-mail, telefone, documento e campos extras) e se cada um é obrigatório. O bloco de endereço é totalmente configurável (ligar/desligar, quais linhas, obrigatoriedade). Os dados coletados são persistidos na transação (inclusive endereço, como metadados).
Métodos
Dois modos:
- Automático — os métodos são resolvidos pela
currencyda cobrança (PIX paraBRL, métodos locais europeus paraEUR, etc.), usando o mesmo roteamento honesto do resto da plataforma. - Manual/override — fixe a ordem, oculte métodos ou destaque um como recomendado.
Idiomas & moedas
Defina os idiomas oferecidos e as moedas habilitadas do modelo (útil principalmente para Links de pagamento, onde o cliente troca a moeda na própria página). Você também pode exibir uma nota de câmbio.
Snapshot na transação
Quando uma cobrança é criada a partir de um modelo, a PagNow tira um snapshot imutável dos métodos e idiomas resolvidos naquele momento e o anexa à transação — assim a página do cliente permanece consistente mesmo que você edite o modelo depois. O branding (cores/textos) é lido ao vivo, então ajustes visuais aparecem na hora.
Redirecionamento pós-pagamento
No modelo você pode configurar uma URL de retorno (e um atraso opcional) para onde o cliente é enviado depois de pagar — por exemplo, a página de "obrigado" da sua loja.
Próximos passos
- Checkout hospedado — o campo
checkoutna criação da cobrança. - Links de pagamento — cobrar por um link compartilhável.
