Pular para o conteúdo
Hotel das Lojas Central de Ajuda

Pix com QR Code, cartão e boleto com a Pagou.ai

Ative o aplicativo Pagou.ai e receba Pix com QR Code, cartão parcelado e boleto na própria loja, com o pedido marcado como pago sozinho.

5 min de leitura Atualizado em 31/10/2026
Neste artigo
  1. 1. Ative o aplicativo
  2. 2. Configure e ligue
  3. O que o cliente vê
  4. Perguntas frequentes
  5. Veja também

A Pagou.ai é um aplicativo de pagamento que funciona dentro da sua loja: depois de finalizar, o cliente escolhe entre Pix (QR Code e "copia e cola"), Cartão de crédito (com parcelas) e Boleto, sem sair da página. Quando o pagamento é aprovado, o pedido muda para Pago sozinho. Você não precisa cadastrar nenhum aviso automático: a loja já informa o endereço a cada cobrança.

Antes de começar
  • Tenha uma conta na Pagou.ai.
  • No painel da Pagou.ai, em Desenvolvedores › Chaves de API, copie a chave secreta (API key) e, se for receber com cartão, a chave pública.
  • Para boleto, ele precisa estar liberado na sua conta Pagou.ai.

1. Ative o aplicativo

  1. Abra Aplicativos. Vá em Aplicativos › Todos os aplicativos e clique na categoria Pagamentos.
  2. Ative a Pagou.ai. No cartão Pagou.ai, clique em Ativar. Aparece "Pagou.ai ativado. Agora configure as chaves em Meios de pagamento e ligue para o checkout."
  3. Vá para a configuração. Clique em Configurar agora.
hoteldaslojas.com.br/painel/aplicativos#pagamentos
Aplicativos de pagamento123
Aplicativos de pagamento
  1. 1Categoria Pagamentos.
  2. 2Cartão da Pagou.ai.
  3. 3Clique em Ativar (se já estiver ativo, aparece Configurar).

2. Configure e ligue

  1. Ligue no checkout. Marque Aceitar Pagou.ai no checkout.
  2. Cole a chave secreta. No campo Chave secreta (API key).
  3. Cole a chave pública. Só é usada para cartão. Ela começa com pk_.
  4. Escolha as formas de receber. Marque Receber com Pix (já vem marcado), Receber com cartão de crédito e/ou Receber com boleto. Pelo menos uma é obrigatória.
  5. Defina as parcelas. Em Parcelas sem juros no cartão (até), escolha de 1 a 12. Em compras pequenas, o sistema diminui as parcelas para que cada uma fique em pelo menos R$ 5,00.
  6. Salve. Clique em Salvar Pagou.ai. Para testar antes, marque Modo de teste (sandbox) e use as chaves de teste.
hoteldaslojas.com.br/painel/meios-pagamento
Configuração da Pagou.ai123456
Configuração da Pagou.ai
  1. 1Marque Aceitar Pagou.ai no checkout.
  2. 2Cole a chave secreta (API key).
  3. 3Chave pública: só para receber com cartão.
  4. 4Escolha as formas: Pix, cartão e/ou boleto.
  5. 5Parcelas sem juros no cartão, de 1 a 12.
  6. 6Clique em Salvar Pagou.ai.

O que o cliente vê

No checkout aparece "Pix, cartão ou boleto (Pagou.ai)". Depois de finalizar, a página Pagamento mostra uma aba para cada forma ligada:

  • Pix: botão Gerar QR Code Pix, o QR Code, o código com o botão Copiar código e o aviso "Aguardando o pagamento. Esta página atualiza sozinha."
  • Cartão de crédito: os dados são digitados em campo seguro da Pagou.ai e não passam pela loja.
  • Boleto: botão Gerar boleto, linha digitável e Abrir boleto. A confirmação pode levar até 3 dias úteis.

Perguntas frequentes

Apareceu "Para ligar Pagou.ai, preencha: …".

Falta a chave secreta ou nenhuma forma de receber está marcada. O cartão também só funciona com a chave pública.

O cliente não consegue gerar o boleto.

O boleto precisa do CPF ou CNPJ do cliente no pedido. Sem ele, a página pede para o cliente escolher Pix ou falar com a loja.

Onde vejo se deu erro?

No cartão da Pagou.ai, em Meios de pagamento, aparece "Último erro" com a data, quando houver.

Veja também

Este artigo ajudou?

Não encontrou o que procurava?

Nossa equipe ajuda você. Diga o endereço da sua loja para agilizar o atendimento.