Pular para o conteúdo

↑↓ navegar ↵ abrir Ctrl↵ nova aba esc fechar

Achou o seu sintoma? A causa provável está em uma linha, e o detalhe na página do link.

O header Authorization não bate: credencial errada, segredo de antes de uma troca no painel (vale só por 24 horas, ou até ser encerrado) ou base64 montado sobre algo diferente de client_id:client_secret. Ver Autenticação.

A empresa está bloqueada na Rapid. As chamadas por credencial param; os webhooks continuam chegando. Ver Empresas bloqueadas.

Passou do limite de requisições. Espere o tempo do header Retry-After e, para volume, use o envio em lote. Ver Rate limit.

O caminho tem diferença: barra sobrando no fim, /api/v1 faltando ou erro de digitação. Ver Códigos de resposta.

Primeiro confira se o webhook está cadastrado e ativo em Configurações › Webhook: sem isso não há entrega nem registro no log. Depois, veja o motivo de cada tentativa no log de entregas do painel, em Atividade, aba Webhooks: ele começa com [https], [destino], [redirecionamento] ou [assinatura] quando a falha não foi uma resposta do seu servidor. Ver Retries e logs.

Quase sempre o corpo foi lido como JSON antes de validar: a assinatura é sobre o corpo bruto, byte a byte. Outras causas: chave já trocada e timestamp fora da janela. Teste com o conferidor de assinatura e compare com os exemplos em Autenticação do webhook.

O seu servidor respondeu fora de 2xx ou demorou mais que o tempo limite. Ver O que conta como sucesso.

É retentativa ou reenvio, com o mesmo alert_id. Ver Idempotência.

O prazo passou ou o alerta já tem status definitivo. A mensagem diz qual dos casos. Ver Transição não permitida.

Busque pelo provider_alert_id. Ver Buscar pelo seu próprio ID.

A empresa não tem Prevenção nem Disputa ativa, e só elas usam transações. Contrate ou ative uma das duas no painel, ou fale com o suporte. Ver Quem envia transações.

Já existe transação sua com o mesmo external_source e external_id. Ver Códigos de erro.

A transação já foi usada por um produto e não pode mais ser alterada. Ver Proteção de imutabilidade.

O merchant_id não é de um merchant da sua empresa. Ver Listar merchants.

Ache pelo identificador que você enviou. Ver Pelo ID do seu sistema.

O corpo passou do tamanho máximo. Divida em lotes menores. Ver Envio em lote.

A transação foi criada, mas faltam campos que melhoram a proteção. Ver Warnings.

A transação não tem o identificador da cobrança no gateway. Ver Nota sobre transaction_id.

Eventos do navegador respondem 403 ORIGIN_NOT_ALLOWED

Seção intitulada “Eventos do navegador respondem 403 ORIGIN_NOT_ALLOWED”

O evento veio de um site que não está entre os sites em que o token vale. Se o site é seu, autorize no cartão do SDK, em Configurações › Integrações. Ver Em qual site o token vale.

O cartão muda quando um evento casa com uma transação sua. Confira se a transação foi enviada e se o order_ref é o mesmo identificador dela. Ver order_ref.

Há eventos demais esperando a transação aparecer. Em geral o order_ref não corresponde a nenhuma transação, ou as transações não estão sendo enviadas. O navegador e o servidor têm tetos separados. No navegador, também pode ser alguém mandando pedidos inventados com o seu token: gere um novo no cartão do SDK para cortar os envios novos; os que já entraram saem da fila sozinhos em cerca de 3 dias. Ver Limite de chamadas.

O recebimento da captura ficou indisponível por um instante e o evento não foi registrado. Reenvie depois dos segundos do header Retry-After, com o mesmo event_id: o reenvio não duplica a evidência. Ver Validações.