Reembolsos
Como reembolsar um pedido pago em Vendas, o que acontece com o acesso do aluno e onde o valor volta.
Onde reembolsar
O reembolso total do pedido é feito em Vendas: na linha do pedido com status Pago, clique no botão Reembolsar. A seção Reembolsos da sidebar (hoje em construção) trará o fluxo de solicitações de reembolso com reconfirmação na API do gateway.
O fluxo do reembolso
Ao clicar em Reembolsar, confirme no diálogo "Reembolsar este pedido na integralidade? O comprador perde o acesso.". A partir daí a plataforma executa, em ordem:
- Reconfirma o pagamento na API do gateway antes de qualquer mudança — se o gateway não confirmar o pagamento como aprovado, o reembolso é bloqueado por segurança.
- Pede o reembolso ao gateway que efetivamente processou a compra (o gateway fixado na compra, não a rota atual de pagamento da conta).
- Marca o pedido como Reembolsado em Vendas.
- Revoga o acesso do aluno — o comprador perde o acesso ao produto (área de membros e entregáveis) no mesmo momento.
O valor volta pelo próprio gateway onde a compra foi feita — o estorno é feito na API daquele gateway, e o prazo para o dinheiro aparecer de volta para o comprador depende do gateway e do método (Pix e boleto costumam ser mais rápidos; cartão segue o prazo da operadora).
Limites e casos especiais
- Só pedidos Pago podem ser reembolsados.
- Gateway sem reembolso via API: se o gateway conectado não suporta estorno automático, o painel avisa e orienta a fazer o reembolso direto no painel do gateway — nesse caso o status do pedido continua Pago até você acionar o suporte para marcá-lo manualmente.
- Pagamento em 2 cartões: reembolsar o pedido estorna as duas parcelas, cada uma no gateway que a cobriu. Se qualquer estorno falhar, nada é aplicado (nunca devolve metade) e o erro é mostrado.
- Fila de compensação manual: se o estorno automático de um split falhou, o card Fila de compensação manual em Vendas oferece o botão Estornar cartão N para você devolver a parcela paga à mão — ao concluir, o pedido inteiro fecha junto.
O que o aluno e as integrações recebem
- O aluno perde o acesso imediatamente após a confirmação do reembolso.
- Apps e integrações conectadas recebem o evento
order.refunded(com dados do pedido: status, método, valor, e-mail do comprador e produto) — útil para sincronizar CRMs e ferramentas de recuperação. - Se o pedido nasceu da API de pagamentos, o webhook cadastrado na aplicação também recebe o
order.refunded.
Mensagens de erro comuns
- "Só pedidos pagos podem ser reembolsados." — o pedido não está mais como Pago.
- "O gateway não confirma este pagamento como aprovado — reembolso bloqueado por segurança." — reconfira o status no gateway; em caso de divergência, use Conferir pgto. no pedido (quando pendente) ou o painel do gateway.
- "Gateway indisponível. Tente novamente em instantes." — falha temporária de comunicação; basta tentar de novo.
Rotina sugerida
- Reembolse sempre pelo botão Reembolsar de Vendas — ele garante a reconfirmação no gateway, a revogação do acesso e o evento
order.refundednas integrações em uma única ação. - Antes de reembolsar por garantia/dispusta, tente resolver com o aluno — depois de reembolsado, o acesso é cortado na hora.
- Confira no Financeiro o rodapé de pedidos reembolsados para conciliar o total devolvido do período com o extrato do gateway.