Como funciona a atualização de pedidos na Uappi

A atualização de status de um pedido está diretamente ligada ao reconhecimento do pagamento dentro da plataforma.

Dependendo da forma de pagamento utilizada (boleto, PIX, cartão, etc.), esse processo pode acontecer de forma imediata ou com algum intervalo de atualização.

Neste artigo, você vai entender como esse fluxo funciona na prática.

O que define um pedido como “Pago”

Um pedido é considerado como Pago na Uappi quando o sistema recebe a confirmação do pagamento e atualiza o status para:

Pago (ID 3)

Essa atualização acontece com base no retorno do meio de pagamento (gateway), e não apenas no momento em que o cliente realiza o pagamento.

Como o pagamento é reconhecido

A confirmação do pagamento pode acontecer por diferentes mecanismos:

• Notificação automática (callback) do gateway
• Consultas automáticas (rotinas internas)
• Retorno direto após o pagamento

Ou seja: o sistema depende da sincronização com o meio de pagamento para atualizar o pedido.

Importante: diferença entre pagamento realizado e pedido atualizado

Em alguns casos, o cliente pode já ter realizado o pagamento, mas o pedido ainda aparecer como:

Aguardando pagamento

Isso acontece porque:

• o sistema ainda não recebeu a confirmação do gateway;
• ou a atualização ainda não foi processada internamente.

Comportamento por tipo de pagamento

Boleto bancário

• O pedido é criado como Aguardando pagamento;
• Após o pagamento, o banco/gateway precisa confirmar a transação;
• A atualização depende do retorno dessa confirmação.

Pode existir um intervalo entre o pagamento e a atualização do pedido.

PIX

• O comportamento é semelhante ao boleto;
• Porém, a confirmação costuma ser mais rápida.

Ainda assim, a atualização depende da sincronização com o gateway.

Cartão de crédito

• O pagamento pode passar por etapas como:
  • autorização;
  • análise antifraude;
  • captura.

O pedido só será considerado Pago quando o pagamento for efetivamente aprovado.

Venda interna / link de pagamento

• Segue o mesmo fluxo dos outros meios de pagamento;
• O pedido só será atualizado quando o pagamento for confirmado pelo sistema.

Análise antifraude

Em pedidos com antifraude:

• O pedido pode permanecer como Aguardando pagamento durante a análise
• Após aprovação:
  • o pagamento é confirmado;
  • o pedido segue para Pago.
• Em caso de reprovação:
  • o pedido pode ser cancelado automaticamente.

Pedidos com mais de um pagamento

Quando um pedido possui múltiplos pagamentos:

• ele só será considerado Pago quando todos os pagamentos forem confirmados.

Possíveis atrasos na atualização

Alguns cenários podem gerar diferença entre o pagamento e o status do pedido:

• atraso na notificação do gateway;
• falha ou atraso na sincronização;
• rotinas automáticas ainda não executadas;
• análise antifraude em andamento.

Exemplo prático (boleto)

Um pedido pode seguir este fluxo:

• Pedido criado → Aguardando pagamento;
• Cliente realiza o pagamento do boleto;
• Gateway confirma o pagamento;
• Sistema recebe/processa essa confirmação;
• Pedido atualizado para → Pago.

Se essa confirmação não chegar a tempo, o pedido pode permanecer temporariamente como “Aguardando pagamento”.

Atenção para cancelamentos automáticos

Algumas regras do sistema consideram:

• tempo desde a criação do pedido;
• status atual no momento da verificação.

Se o pedido ainda estiver como Aguardando pagamento, ele pode ser cancelado automaticamente, mesmo que o pagamento já tenha sido realizado, mas ainda não reconhecido pela plataforma.

O que fazer em caso de divergência

Se você identificar que o pagamento foi realizado, mas o pedido ainda não foi atualizado:

1. Verifique o status do pedido na plataforma

Confirme se o pedido ainda está como Aguardando pagamento.

Para entender melhor os status e como funcionam, consulte também o artigo:
“Status de pedidos: diferença entre Ordem e ID”.

2. Aguarde o tempo de sincronização

Em alguns casos, a atualização pode levar alguns minutos ou horas, dependendo do meio de pagamento.

3. Consulte o gateway de pagamento

Verifique diretamente no painel do seu gateway:

• se o pagamento está como aprovado / capturado;
• se houve alguma falha ou pendência.

O gateway é a fonte original da informação de pagamento.

Resumo geral

• O status do pedido depende da confirmação do pagamento pelo sistema;
• Nem sempre o pagamento é refletido imediatamente;
• Cada forma de pagamento tem seu próprio tempo de atualização;
• O pedido só muda para Pago quando o sistema reconhece oficialmente a transação;
• Em casos específicos, pode haver diferença temporária entre pagamento e status.

Dúvidas

Acesse nosso Help Center para mais conteúdos sobre a plataforma Uappi!