Forçar atualização de pedidos no Woo

Na integração PagBank Connect para WooCommerce você pode optar por Forçar a atualização do pedido.

Esta opção está localizada nas configurações gerais do plugin no menu PagBank > Configurações.

Ao ativar esta opção, sua loja buscará por atualizações de forma pro-ativa, sem depender do sucesso nos retornos em tempo real enviados pelo PagBank.

Quando deve ser utilizado?

Este recurso deve ser usado somente você estiver tendo problemas para receber as notificações sobre atualizações de pedidos enviadas pelo PagBank à sua loja. Este tipo de problema é geralmente causado por bloqueios de firewall, mod_security ou instabilidade do provedor de hospedagem.

Com que frequência a atualização ocorre?

A cada 6 horas, mas pode variar de acordo com o meio de pagamento escolhido e com o status do mesmo.

Boleto: a cada 6 horas até 3 dias após a data de vencimento do mesmo.

Cartão: a cada 6 horas por 3 dias.

PIX: a cada hora nas primeiras 3 horas e a cada 6 horas na primeira semana. No caso do pix, uma verificação adicional é feita antes do mesmo ser cancelado.

Que pedidos/status são processados na atualização?

Qualquer pedido feito com PagBank Connect cujo status seja Pagamento Pendente ou Aguardando.

Notificações de cancelamento, disputas e reembolsos não serão processadas por esta tarefa. Por isso é importante garantir que não há problemas no recebimento das notificações do PagBank em sua loja.

Como sei se um pedido foi atualizado pela notificação do PagBank ou por este recurso?

Atualizações feitas de forma pró-ativa (com esse recurso) possuem a marcação "(Atualizado via Cron)" nos seus comentários.

Posso modificar o plugin para que seja atualizado com mais frequência?

Não. Ao fazer isso há o risco de ter a conta suspensa na API do PagBank.

Note que o recurso deve ser usado de forma paliativa, a fim de resolver eventuais problemas que você tem em sua loja. Idealmente você deveria resolver o problema de recebimento das notificações do PagBank para não precisar disso. :)

Este recurso deixará minha loja mais lenta?

Se você não tiver um cron real configurado em sua loja, sim. Ou seja, se você não tem um cron configurado, o WordPress executa as tarefas agendadas de todos os plugins quando algum usuário aleatório acessa sua loja. Se você tiver muitos pedidos a serem processados/verificados, isso pode causar lentidão na visita deste usuário ou administrador.

O ideal é que se desabilite o cron (define('DISABLE_WP_CRON', true);) e ative a execução de um cronjob real (ex: 0 * * * * curl --silent "https://seusite.com/wp-cron.php?"... ).

Posso usar em conjunto com as notificações padrão do PagBank?

Certamente. O módulo guarda uma imagem do status do pedido no PagBank e só atualiza se houver mudanças.

Não encontrei a opção na minhas configurações.

Você talvez não esteja usando nosso módulo ou está usando uma versão anterior à 4.31.0.

Como sei quando o pedido será atualizado novamente?

O identificador do cron desta tarefa é identificado como rm_pagbank_cron_force_order_update e é executado de hora em hora.

Como saber se este recurso está realmente atualizando os pedidos?

Quando um pedido sofre uma atualização de forma forçada o comentário (Atualizado via Cron) é adicionado na atualização do pedido.

No entanto, nos casos onde não há nenhuma mudança no pedido, apenas no log do plugin é adicionado uma mensagem como esta:

2025-02-28T01:13:12+00:00 DEBUG Notificação de atualização ignorada para o pedido 6887 pois o conteúdo é o mesmo da última atualização. (Atualizado via Cron)