Error Codes

HTTP Codes (Infrastructure)

HTTP Code	Description	Affected Methods	Recommended Action
`401`	Invalid or expired authentication token	All	Verify Basic Auth credentials
`403`	Access denied/Insufficient permission	All	Validate user permissions
`500`	Internal server error	All	Try again in a few minutes
`503`	Service temporarily unavailable	All	Wait for service to return

HTTP Code	Scenario	FitBank Action	Notes
`200`	Webhook processed successfully	No re-send	Confirmation received
`4xx`	Client error (invalid URL, timeout)	Tries to re-send up to 5 times	Exponential backoff
`5xx`	Server error on client side	Tries to re-send up to 5 times	Exponential backoff
`Timeout`	Client does not respond within 30s	Considers as failed and re-sends	Maximum 5 attempts

Format: ISI + 4 digits (e.g. ISI0001)
Type: Business errors (HTTP 200 with Success: false)
Origin: Validations by the PIX API

Code	Message	Detailed Description	Category
`ISI0001`	Method executed successfully	Operation performed without errors	Success
`ISI0002`	Invalid parameters	Required fields are missing or have incorrect format	Validation
`ISI0003`	Duplicate PIX key	PIX key already exists in the system	Duplication
`ISI0004`	Blocked CPF/CNPJ	Document is on the restricted list	Compliance
`ISI0005`	Invalid origin account	Origin account banking information is incorrect	Validation
`ISI0006`	Invalid value	Value must be greater than zero	Validation
`ISI0007`	Invalid PIX key	PIX key format is incorrect	Validation
`ISI0008`	Transaction not found	PIX transaction does not exist	Query
`ISI0009`	Cancellation not allowed	Transaction is already processed or has a final status	Business
`ISI0010`	Invalid status	Current status does not allow the operation	Business
`ISI0011`	Permission denied	User is not authorized to perform the operation	Authorization
`ISI0012`	Account not found	User account was not located	Query
`ISI0013`	Insufficient balance	Account does not have enough balance for the transaction	Business
`ISI0014`	PIX key not found	PIX key is not registered in the system	Query
`ISI0015`	Limit exceeded	Value exceeds the configured limit	Business
`ISI0016`	Invalid QR Code	PIX QR Code is invalid or expired	Validation

Formato: EXC + 4 dígitos (ex: EXC0001)
Tipo: Códigos de exceção/erro de processo
Origem: Regras de negócio PIX e validações automáticas

Código	Mensagem Literal	Contexto	Status Relacionado
`EXC0001`	Falha na validação KYC do usuário	Análise KYC reprovada	Cancelado
`EXC0002`	CPF/CNPJ não encontrado	Person não encontrada no sistema	Validação
`EXC0003`	Conta não foi encontrada	Account não encontrada com dados informados	Validação
`EXC0004`	Erro de configurações {0} para BusinessUnitId {1}	MatchingBusinessUnit não configurada	Configuração
`EXC0005`	Não foi possivel encontrar as Informações da conta do Pagador	AccountHolder não encontrado	Validação
`EXC0006`	Erro interno de processamento	Falha no sistema interno	Erro
`EXC0007`	Chave PIX bloqueada	Chave bloqueada por suspeita de fraude	Bloqueado
`EXC0008`	Conta destinatária bloqueada	Conta bloqueada na instituição	Cancelado
`EXC0009`	Tipo de chave não suportado	Tipo de chave PIX inválido	Validação
`EXC0010`	QR Code expirado	QR Code além do prazo de validade	Expirado
`EXC0018`	Por favor informar o DocumentNumber ou EndToEndId ou ConciliationId.	Identificador obrigatório não informado	Validação
`EXC0019`	Não foi encontrada transação com os dados informados	Transação PIX não encontrada ou dados inconsistentes	Consulta
`EXC0023`	EXC0023 - Recebimento em processamento. Tente novamente em alguns instantes.	Transação em processamento	Processando

Format: INF + 4 digits (e.g. INF0001)
Type: Informative codes
Origin: System notifications and information

Code	Description	Context	Related Status
`INF0001`	Transaction processed successfully	PIX transaction completed	Cleared
`INF0002`	PIX key created successfully	PIX key registration completed	Active
`INF0003`	Refund processed	PIX refund processed	Refunded
`INF0004`	QR Code generated successfully	QR Code created	Active
`INF0005`	PIX key removed	PIX key removal processed	Removed
`INF0006`	Transaction under analysis	PIX transaction under compliance analysis	Analyzing
`INF0007`	Awaiting confirmation	Waiting for user confirmation	Pending
`INF0008`	PIX key in portability	Portability process initiated	Transferring