Falhas comuns de pagamento

Antes de cobrar

• Confirme em Configurações → Conectividade que a plataforma tem Stripe configurado no ambiente.
• No curso, Aceitar Stripe deve estar ligado se a cobrança for online.
• Taxa ou plano precisam ter valor maior que zero para gerar checkout.

Problemas frequentes

| Sintoma | Causa provável | O que fazer |

| --- | --- | --- |

| Botão Conectar Stripe desativado | Ambiente em cobrança direta (Connect desligado) | Use o checkout normalmente na conta da plataforma; Connect só quando a Snapp ativar. |

| Mensagem de Connect não ativo / não configurado | Plataforma sem chave Stripe ou sem Connect no Dashboard | Contate o suporte da plataforma; a instituição não resolve sozinha no painel. |

| Checkout não abre / erro ao gerar QR | Sessão Stripe rejeitada (moeda, capability ou valor) | Confira a moeda da instituição, o valor do plano e se a conta Stripe aceita essa moeda; gere um novo checkout. |

| Pagamento Falhou após abrir o link | Sessão expirada ou pagamento não concluído | Gere um novo link/QR; peça ao pagador para concluir sem fechar a aba cedo demais. |

| Aluno pagou mas status ainda Pendente | Atraso de confirmação (webhook) | Aguarde alguns segundos e atualize a candidatura; a plataforma também reconcilia sessões abertas. |

| PIX indisponível | Moeda diferente de BRL ou conta sem PIX | Em BRL, cartão + PIX quando a conta permitir; demais moedas tipicamente só cartão. |

| Valor “errado” no QR | Plano ou taxa desatualizados na sessão antiga | Selecione de novo o plano/taxa e regenere o checkout. |

Boas práticas

• Não reutilize links de checkout muito antigos.
• Após mudar moeda ou comercial do curso, sempre gere um novo checkout.
• No presencial, registre métodos manuais apenas quando o pagamento realmente ocorreu fora do Stripe.