Skip to main content

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.

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