Manual de Erros

A seguir, os principais erros das APIs de PIX IN e PIX OUT, com o código HTTP, a mensagem retornada e uma descrição clara.

StatusCode	message	Descrição
401	Unauthorized access. Check your credentials	Credenciais inválidas ou ausentes no header x-authorization-key.
400	headers 'x-store-key' is missing	Chave pública (x-store-key) não enviada; necessária em alguns cenários.
400	Payment method not allowed on this dynamic link	Método de pagamento não habilitado para este link dinâmico.
400	Payment method not allowed based on seller settings	Método de pagamento não autorizado pelas configurações do vendedor.
400	Limit of ticket value reached	Valor do pedido acima do limite máximo. Tente reduzir o valor.
400	Minimum ticket value reached	Valor do pedido abaixo do mínimo. Tente aumentar o valor.
400	PixKey is required	A chave Pix (pixKey) não foi informada; obrigatória para PIX OUT.
400	Invalid pixKeyType, use [cpf, cnpj, phone, email]	Tipo de chave Pix (pixKeyType) inválido ou ausente; use cpf, cnpj, phone ou email.
400	Withdraw pixKey: 12345678910, amount: R$1.00 already processed, please try again in 60 seconds	Saque duplicado detectado; aguarde 60 segundos antes de tentar novamente.
400	Permission denied	Sem permissão para executar a ação; restrições de acesso ou regras do sistema.
400	Minimum withdraw value is R$1.00	Valor do saque abaixo do mínimo permitido (R$ 1,00).
400	Insufficient Balance! Withdraw amount: R$10.00, Taxes: R$1.00, Available balance: R$5.00	Saldo insuficiente para cobrir valor do saque e taxas.
400	Daily limit exceeded. Limit: R$1000.00, Today Amount: R$990.00	Limite diário de saques excedido; aguarde o próximo dia para novas operações.
404	Resource not found	Endpoint ou recurso não encontrado; verifique a URL e parâmetros.
422	Validation error: <detalhes>	Erro de validação nos dados; revise o formato e valores dos campos.
429	Too many requests. Please try again later.	Muitas requisições em curto período (rate limit); aguarde alguns segundos antes de tentar novamente.
500	Internal server error	Erro interno no servidor; tente novamente mais tarde ou contate o suporte.