QR Code expirou — como gerar novo e o que muda

Você gerou um QR Code DEPIX, mandou pro cliente, e ele demorou pra pagar. Quando volta, o QR já expirou. Calma — não tem mistério. Esse guia mostra quanto tempo cada QR dura, o que acontece se o cliente paga depois do prazo, e como gerar um novo em segundos.

Prazos por tipo de QR

O que acontece se o cliente pagar QR expirado?

Cliente vai no app do banco, escaneia QR vencido, e tenta pagar. Dois cenários:

Cenário 1 — Banco do cliente já detecta expiração

App mostra mensagem: "QR expirado, gere um novo". Cliente não consegue pagar, te avisa, você gera outro QR e manda. Sem prejuízo.

Cenário 2 — App processa mesmo expirado

Alguns apps menos rigorosos enviam o PIX. Aí três sub-cenários:

• parceiro de pagamento regulado detectam: PIX é rejeitado no recebimento, valor volta pra conta do cliente em até 48 horas
• PIX chega à PSP: PSP recusa porque o ID já não está ativo no nosso sistema. Cliente recebe estorno automático
• Caso raríssimo — chega mesmo expirado: webhook recebe e tentamos casar com checkout. Se ainda existir, DEPIX é creditado normalmente. Se foi cancelado, valor é reembolsado pra conta do cliente

Em todos os casos o cliente NÃO perde dinheiro. PIX volta em até 48 horas se não foi processado com sucesso. Tranquiliza ele.

Como gerar novo QR (cliente vai pagar agora)

Via Dashboard (/depix avulso)

1. Acesse /depix
2. Digita o valor, toca em Continuar e informa o CPF ou CNPJ do pagador
3. Toca em Cobrar
4. Manda o QR Code novo (ou o código Pix Copia e Cola) pro cliente — 20 min na conta

Via Minha Loja (cliente comprou produto)

Se a venda foi via /loja com checkout (pixgo.org/pay/XYZ):

1. Manda de novo o link do checkout (pixgo.org/pay/XYZ) pro cliente
2. O cliente finaliza a compra de novo
3. Um QR novo é gerado na hora, valendo 20 minutos

Via API (programador)

Reemissão é simplesmente uma nova chamada POST /api/v1/payment/create. O payment_id antigo continua válido se estiver no prazo, ou expira automaticamente.

curl -X POST https://pixgo.org/api/v1/payment/create \
  -H "X-API-Key: SUA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 50.00, "description": "Pedido #1234", "receiver_cpf": "12345678900"}'

Por que QRs têm tempo curto?

Três motivos:

• Cotação DEPIX/BRL é 1:1, mas o sistema reserva o slot: cada QR ocupa um payment_id ativo na PSP. Se ficasse aberto pra sempre, o pool acumularia
• Antifraude: QR de 24h tem 24h pra ser interceptado/fraudado. QR de 20min reduz drasticamente a janela
• Limpeza do Dashboard: usuário ativo gera vários QRs/dia. Sem expiração, lista de pendentes ficaria gigante

Truques pra QR não expirar (cenários comuns)

Venda demorada (cliente conferindo produto)

Se você sabe que o cliente vai demorar (conversando, dúvidas, escolhendo), não mande o QR de cara. Mande só quando ele confirmar que vai pagar. Assim os 20 min começam quando ele realmente vai usar.

Vendas agendadas (recorrente, mensal)

Pra cobrança mensal/semanal, use o módulo de Recorrência via API. O sistema gera QR automaticamente 1-2 dias antes do vencimento e cancela se não pagar até prazo configurado.

Cliente que vai pagar mais tarde

Se sua venda é tipo "cliente paga até amanhã", gere o QR só na hora em que ele for pagar. Pela API, é uma nova chamada a POST /api/v1/payment/create. Funciona pra carrinho abandonado, cobrança de booking, etc.

Erros comuns

Cliente diz "paguei, comprovante anexo" mas QR estava expirado

1. Confere no Dashboard se o checkout chegou a completed
2. Se NÃO chegou: o PIX vai voltar pra ele em até 48 horas. Tranquiliza, espera
3. Se chegou (raríssimo): DEPIX já está na carteira, segue a vida
4. Cliente impaciente? Pede o comprovante (PDF do banco) e confere o "PSP/Recebedor": se aparecer o nome de uma instituição de pagamento, e não o da sua loja, foi processado mesmo expirado

Venda no WhatsApp + cliente paga 8h depois

QR expirou. Cliente acha que pagou (porque viu confirmação no app dele). Mas o PIX vai voltar pra ele. Pode levar até 48 horas. Pede pra ele esperar, e quando voltar, gere outro QR.

"Antes funcionava com QR de 1h, agora só 20min"

Não mudou nada. DEPIX avulso sempre foi 20min. Se o cliente precisa de mais tempo, gere um QR novo na hora em que ele for pagar.

FAQ QR expirado

Cliente vai cobrar quem se o PIX voltar?

Cliente cobra dele mesmo (o banco devolve). Você (vendedor) não tem nada a ver com o estorno — você gera novo QR se ele insistir em pagar.

Reemitir tem custo?

NÃO. Reemissão é gratuita e ilimitada. Você só paga taxa sobre venda paga: 2% (+ R$1 nas vendas de R$10 a R$49,99) + R$0,50 por envio D+1.

Posso configurar QR avulso pra durar mais que 20min?

Não. Todo QR vale 20 minutos (Gerar Cobrança, Minha Loja e API). Gere um novo quando o cliente for pagar.

O QR expira por inatividade do cliente?

Não. O prazo é fixo a partir da criação. Cliente abrir, fechar, voltar — o cronômetro continua rodando.

Como ver tempo restante de um QR específico?

No Dashboard, lista de pedidos mostra created_at. Faz a conta: 20min a partir dali. API v1 retorna expires_at no payload.

Posso cancelar QR antes de expirar?

Sim. No Dashboard, botão Cancelar na lista de pedidos. Status muda pra cancelled, cliente que tentar pagar recebe estorno.

O número que muda no novo QR é o quê?

payment_id (interno PixGo) E txid (PSP) são novos. O endereço Liquid recebedor (sua wallet) continua o mesmo. Cliente só precisa escanear o novo QR.

Resumo prático

• DEPIX avulso, Loja e API: 20min
• Cliente paga QR expirado: PIX volta pra ele em até 48 horas, sem dano
• Reemissão gratuita e instantânea, mesmo link Loja
• Pra venda demorada: só manda QR quando cliente vai pagar de fato
• Pra recorrente/booking: gera o QR na hora do pagamento (API ou módulo de recorrência)
• Comprovante mostrando parceiro de pagamento regulado = passou; resto = vai estornar

Leituras relacionadas: PIX pago, DEPIX não caiu · API PixGo · Banco do cliente acusa golpe