Como trocar de gateway sem perder pedidos abertos

Trocar o gateway pode ser uma melhoria feliz para a loja, desde que os pedidos em andamento sejam tratados antes da mudança. O objetivo é colocar o novo meio no

Publicado em 19/09/2026
Atualizado em 22/09/2026
Equipe do Interago

Trocar o gateway pode ser uma melhoria feliz para a loja, desde que os pedidos em andamento sejam tratados antes da mudança. O objetivo é colocar o novo meio no checkout sem apagar histórico, duplicar cobrança ou abandonar quem já iniciou o pagamento.

Para quem é

Lojista, atendimento ou financeiro que precisa mudar o meio de pagamento e quer preservar pedidos abertos e a rotina de conferência.

Função

Organizar uma troca segura de gateway, mantendo a visão dos pedidos existentes e separando o fluxo antigo do fluxo de novas compras.

Como chegar

Objetivo	Caminho
Mapear pedidos abertos	Extensões → Checkout → Pedidos
Ver o meio configurado	Extensões → Checkout → Pagamentos
Conferir regras da compra	Extensões → Checkout → Configurações
Publicar o novo checkout	Extensões → Checkout → Atualizar

Regra de ouro

Não apague pedidos antigos para trocar o gateway. Um pedido que já existe deve continuar sendo conferido pelo caminho que o originou. O novo gateway vale para novas compras depois da publicação, salvo orientação diferente do próprio meio.

Se houver dúvida sobre um pedido pendente, preserve o cenário, confira o status no meio original e converse com o cliente antes de criar uma nova cobrança.

Checklist antes da troca

[ ] Selecione o website correto em Meus websites.
[ ] Abra Extensões → Checkout → Pedidos.
[ ] Filtre os pedidos abertos, aguardando pagamento ou aguardando conferência.
[ ] Anote, na rotina interna da loja, o número visível do pedido, o valor, a data, o cliente e o status atual.
[ ] Separe os pedidos que já foram pagos dos que ainda não têm confirmação.
[ ] Não altere status para limpar a lista.
[ ] Avise atendimento e financeiro sobre a janela da troca.
[ ] Mantenha o acompanhamento do gateway antigo para os pedidos já criados.

Entenda cada situação

Situação do pedido	Ação segura
Aguarda pagamento	Confira o meio original e fale com o cliente antes de gerar outra cobrança.
Pagamento confirmado	Siga a operação normal. Não cobre novamente por causa da troca.
Pagamento em conferência	Aguarde a confirmação esperada e registre a próxima verificação.
Pagamento recusado ou expirado	Informe o cliente e ofereça uma nova compra somente quando o primeiro fluxo estiver encerrado.
Cancelado	Não reabra por tentativa. Se necessário, crie uma nova compra com consentimento do cliente.

A lista de pedidos continua sendo a referência operacional. Para separar um pedido que não aparece ou um pagamento que não confirma, use Checklist: pedido não aparece ou pagamento não confirma.

Ative o novo gateway

Depois de mapear os pedidos, faça a troca no painel:

Abra Extensões → Checkout → Pagamentos.
Conclua a configuração do novo meio no respectivo guia.
Não remova a configuração antiga enquanto houver pedidos que dependam dela para conferência.
Salve o novo meio.
Abra Checkout → Atualizar.
Atualize o checkout.
Faça uma compra de teste como visitante.
Confirme que a nova compra aparece com o novo status esperado.

As etapas próprias de cada provedor ficam em Configurando Mercado Pago, PagBank no checkout e Configurando o Stripe - Pagamentos. Este artigo não repete esses campos.

Depois da publicação

faça uma compra de teste única;
confirme o pedido em Pedidos;
mantenha uma lista curta dos pedidos antigos até todos terem destino definido;
comunique ao atendimento qual meio vale para novas compras;
só encerre o acompanhamento do gateway antigo quando não houver pedido aberto dependente dele e o financeiro concordar.

Se o novo meio falhar, não transforme a falha em uma segunda troca imediata. Siga Como agir quando o gateway falha no meio do mês e preserve os pedidos já existentes.