Problemas comuns
Achou o seu sintoma? A causa provável está em uma linha, e o detalhe na página do link.
Credenciais e acesso
Seção intitulada “Credenciais e acesso”Toda chamada responde 401
Seção intitulada “Toda chamada responde 401”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 API responde 403 COMPANY_BLOCKED
Seção intitulada “A API responde 403 COMPANY_BLOCKED”A empresa está bloqueada na Rapid. As chamadas por credencial param; os webhooks continuam chegando. Ver Empresas bloqueadas.
Recebo 429
Seção intitulada “Recebo 429”Passou do limite de requisições. Espere o tempo do header Retry-After e, para volume, use o envio em lote. Ver Rate limit.
Recebo 404 NOT_FOUND num endpoint que existe
Seção intitulada “Recebo 404 NOT_FOUND num endpoint que existe”O caminho tem diferença: barra sobrando no fim, /api/v1 faltando ou erro de digitação. Ver Códigos de resposta.
Webhook
Seção intitulada “Webhook”Nenhum webhook chega
Seção intitulada “Nenhum webhook chega”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.
A assinatura nunca bate
Seção intitulada “A assinatura nunca bate”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 log mostra falha, mas o meu servidor recebeu
Seção intitulada “O log mostra falha, mas o meu servidor recebeu”O seu servidor respondeu fora de 2xx ou demorou mais que o tempo limite. Ver O que conta como sucesso.
O mesmo alerta chegou duas vezes
Seção intitulada “O mesmo alerta chegou duas vezes”É retentativa ou reenvio, com o mesmo alert_id. Ver Idempotência.
Alertas
Seção intitulada “Alertas”422 ALERT_INVALID_STATUS ao responder um alerta
Seção intitulada “422 ALERT_INVALID_STATUS ao responder um alerta”O prazo passou ou o alerta já tem status definitivo. A mensagem diz qual dos casos. Ver Transição não permitida.
Não sei o id do alerta, só o do provedor
Seção intitulada “Não sei o id do alerta, só o do provedor”Busque pelo provider_alert_id. Ver Buscar pelo seu próprio ID.
Transações
Seção intitulada “Transações”403 PRODUCT_NOT_ACTIVE ao enviar transação
Seção intitulada “403 PRODUCT_NOT_ACTIVE ao enviar transação”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.
409 TRANSACTION_DUPLICATE
Seção intitulada “409 TRANSACTION_DUPLICATE”Já existe transação sua com o mesmo external_source e external_id. Ver Códigos de erro.
409 TRANSACTION_IMMUTABLE
Seção intitulada “409 TRANSACTION_IMMUTABLE”A transação já foi usada por um produto e não pode mais ser alterada. Ver Proteção de imutabilidade.
404 MERCHANT_NOT_FOUND
Seção intitulada “404 MERCHANT_NOT_FOUND”O merchant_id não é de um merchant da sua empresa. Ver Listar merchants.
Perdi o id da transação
Seção intitulada “Perdi o id da transação”Ache pelo identificador que você enviou. Ver Pelo ID do seu sistema.
413 PAYLOAD_TOO_LARGE no envio em lote
Seção intitulada “413 PAYLOAD_TOO_LARGE no envio em lote”O corpo passou do tamanho máximo. Divida em lotes menores. Ver Envio em lote.
A resposta traz warnings
Seção intitulada “A resposta traz warnings”A transação foi criada, mas faltam campos que melhoram a proteção. Ver Warnings.
Disputa chegou sem a transação associada
Seção intitulada “Disputa chegou sem a transação associada”A transação não tem o identificador da cobrança no gateway. Ver Nota sobre transaction_id.
Captura
Seção intitulada “Captura”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 do SDK não mostra “capturando”
Seção intitulada “O cartão do SDK não mostra “capturando””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.
Recebo 429 TOO_MANY_PENDING_EVENTS
Seção intitulada “Recebo 429 TOO_MANY_PENDING_EVENTS”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.
Recebo 503 CAPTURE_TEMPORARILY_UNAVAILABLE
Seção intitulada “Recebo 503 CAPTURE_TEMPORARILY_UNAVAILABLE”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.