Nesta documentação

Assinaturas e cobranças

Pagamentos de checkout

A tela que mostra todo pagamento iniciado no checkout, inclusive os que falharam antes de virar assinatura, e como ler um pagamento que não provisionou.

Ver esta página em markdown, pronta para colar em um assistente de IA.

Atualizada em

Quando alguém assina, o dinheiro é cobrado antes de a assinatura existir. Esse primeiro pagamento tem uma tela só para ele: Financeiro → Pagamentos de checkout.

Por que ele não é uma cobrança

Uma cobrança pertence a uma assinatura e entra na máquina de retentativas: falhou, tenta de novo daqui a dois dias, até cinco vezes. Um pagamento de checkout não pode funcionar assim. Quem está na tela do checkout ou paga agora, ou não assina. Insistir dias depois no cartão de alguém que desistiu não faz sentido, e criar a assinatura antes de o dinheiro entrar cria assinante fantasma.

Por isso a ordem é: cobra primeiro, cria a assinatura depois.

  1. A pessoa preenche o checkout. Enquanto o pagamento não é confirmado, ela é um lead, não um cliente.

  2. A plataforma registra o pagamento de checkout e tenta cobrar.

  3. Se o pagamento falha, nada mais acontece. Não existe cliente, assinatura, cobrança nem pedido: só o registro da tentativa, nesta tela. O comprador pode tentar de novo na mesma tela, e a nova tentativa reaproveita o mesmo pagamento, então enviar duas vezes não gera duas cobranças.

  4. Se o pagamento dá certo, a plataforma: promove o lead a cliente, cria a assinatura, registra este pagamento como a primeira cobrança dela (já como Sucesso), gera o pedido e envia o email de boas-vindas.

As situações

Todo pagamento tentado no checkout está em uma destas quatro situações:

SituaçãoSignifica
Pendentecriado, ainda sem resultado do provedor
Aguardando pagamentoé um PIX, e o QR code ainda não foi pago
Sucessoo dinheiro entrou
Falharecusado, expirado ou reembolsado antes de provisionar

A tela

A lista tem Comprador (com link para o cliente ou para o lead), Plano, Valor, Status, Assinatura e Criado em, com busca e filtros por situação e por período.

Abrindo um pagamento, além desses dados você vê:

  • O motivo da recusa devolvido pelo provedor, em vermelho abaixo do status.
  • O método usado e o identificador da transação no provedor, que é o que o suporte do provedor pede quando você abre um chamado.
  • A assinatura gerada, ou Nenhuma assinatura criada, com a data de provisionamento quando houver.
  • A composição do valor, separando assinatura, frete e desconto, com o cupom aplicado.

Pago, mas sem assinatura

O caso que mais exige atenção é o pagamento em Sucesso com Nenhuma assinatura criada. Significa que o dinheiro entrou e o provisionamento não completou, quase sempre por falta de kit para o período contratado.

A plataforma tenta se recuperar sozinha: a cada hora, uma rotina reprocessa os pagamentos pagos que ficaram sem assinatura. Na maioria dos casos o problema se resolve assim que a causa some (por exemplo, quando você cria o kit que faltava).

PIX no checkout

Quando o clube aceita PIX, o checkout leva a uma página com o QR code, que fica esperando o pagamento. O código vale 30 minutos.

Enquanto isso, o pagamento fica em Aguardando pagamento e nada é provisionado. Se o prazo passar sem pagamento, ele vira Falha, e a própria página oferece gerar um código novo.

Reembolsos

Depois que a assinatura existe, o reembolso é emitido pela ficha da primeira cobrança dela, como qualquer outro. Veja Reembolsos. Um reembolso feito no painel do provedor chega aqui sozinho, e o efeito depende do momento:

  • Já tinha provisionado: a primeira cobrança da assinatura ganha o selo Reembolsada, com a data. A assinatura continua existindo, e cancelá-la, se for o caso, é uma decisão sua.
  • Ainda não tinha provisionado: o pagamento passa a Falha, e a assinatura nunca chega a ser criada. É o comportamento que evita despachar uma caixa para quem já teve o dinheiro de volta.
pagamento, checkout, assinatura, provisionamento, reembolso, PIX