Venda aprovada na adquirente, mas pendente no gateway
📌 Como funciona a atualização de status
A atualização de status ocorre via webhook, enviado pela própria adquirente.
Fluxo simplificado:
Venda é criada no gateway
Pagamento é processado pela adquirente
A adquirente envia um webhook informando o novo status (ex:
paid)O gateway recebe esse webhook e atualiza o pedido no painel para concluído.
👉 Sem webhook de confirmação do pagamento da adquirente, o status da venda não atualiza devidamente.
❗ Por que a venda fica pendente no gateway?
Os motivos mais comuns são:
Webhook não foi enviado pela adquirente
Webhook foi enviado para uma URL antiga ou incorreta
Falha de autenticação ou assinatura inválida
Payload fora do padrão esperado
✅ Procedimento recomendado (passo a passo)
1️⃣ Solicitar o reenvio do webhook
O primeiro passo é pedir para o suporte da adquirente reenviar o webhook da transação.
Algumas adquirentes permitem isso diretamente pelo painel, através da opção “Reenviar webhook” por exemplo.
2️⃣Se o webhook já foi reenviado e o status não atualizou
Caso a adquirente informe que o webhook já foi reenviado, mas o pedido continue pendente no gateway, é necessário solicitar evidências técnicas do envio.
Peça exatamente as seguintes informações:
Horário exato do envio do webhook
URL (rota) para onde o webhook foi disparado
Payload completo enviado no webhook (JSON)
Response retornada pela API do gateway (HTTP Status + body)
Esses dados são essenciais para validar se:
O webhook realmente foi enviado
A URL estava correta
O gateway recebeu a requisição
O payload foi aceito ou rejeitado
📦 Exemplo do que esperamos receber da adquirente
🔗 URL (rota)
https://seu-dominio.com/api/webhooks/adquirente
📤 Payload enviado (exemplo)
{ "event": "transaction.paid", "transaction_id": "trx_123456", "external_id": "order_78910", "status": "paid", "amount": 15000, "payment_method": "credit_card", "created_at": "2025-12-12T14:32:10Z" }📥 Response retornada pelo gateway
Exemplo de sucesso:
{ "success": true }Status HTTP: 200
Exemplo de erro:
{ "error": "Invalid payload" }Status HTTP: 400
🔍 Informações importantes
Se o webhook não chegar, o gateway não consegue atualizar o status manualmente
O controle de envio e reenvio de webhook é responsabilidade da adquirente
O gateway apenas recebe, valida e processa o evento
Por isso, em cenários como esse, o contato principal deve ser o suporte da adquirente.
🏷️Modelo de mensagem para enviar à adquirente
Identificamos que a venda consta como paga no painel de vocês, porém segue pendente no gateway.
Poderiam, por favor, nos encaminhar:
O horário exato do envio do webhook
A URL para onde o webhook foi enviado
O payload completo (JSON) enviado
A response retornada pela API (status HTTP e body)
Caso possível, solicitamos também o reenvio do webhook.
O procedimento acima se aplica independentemente da adquirente utilizada.
Com essas informações em mãos, nossa equipe consegue analisar tecnicamente e identificar se a inconsistência está no envio do webhook, no payload ou na comunicação com o gateway.
Como reenviar o webhook do gateway para aplicações externas
Acesse: Painel de produtor -> Vendas -> Transações -> Clica nos três pontinhos
Dessa forma é possível acessar a opção de Reenviar webhook para o status atual e assim reenviar o webhook do gateway para sua aplicação externa.