LeonaPayComo entender o status de uma transação
Diferencie cobranças criadas, pendentes, com ação necessária, pagas, falhas, expiradas ou estornadas.
Status intermediários ainda não confirmam pagamento
CREATED indica criação; PENDING significa que a LeonaPay ainda aguarda a confirmação; ACTION_REQUIRED pede uma ação do pagador, como autenticação de cartão; AUTHORIZED representa autorização, mas pode ainda não ser a liquidação final.
Leia o resultado final
PAID é o estado de pagamento confirmado. FAILED indica falha, EXPIRED indica que a cobrança perdeu a validade, CANCELLED indica cancelamento e REFUNDED identifica um pagamento estornado. O painel traduz esses estados e mantém a trilha de eventos no detalhe.
- Abra o detalhe da transação.
- Confira o status atual e o horário do último evento.
- Compare o ID e a referência com seu pedido.
- Em integrações, valide também o webhook assinado ou consulte a API antes de atualizar seu sistema.
Trate atualizações com segurança
Eventos podem chegar depois de uma consulta ou ser reenviados. Seu sistema deve deduplicar eventos, aceitar atualizações assíncronas e preservar o estado mais recente conhecido sem considerar o retorno do navegador como confirmação.
Nunca libere um pedido apenas porque a cobrança foi criada, o QR Code apareceu, o boleto foi emitido ou o comprador voltou à sua página.
Precisa de ajuda com o seu caso?
Se a orientação não resolveu, fale com o suporte. Não envie senhas, códigos de acesso ou chaves de API.
Entrar em contato