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

Format: EXC + 4 digits (e.g., EXC0001)
Type: Exception/error codes for processes
Origin: Pix business rules and automatic validations

Code	Literal Message	Context	Related Status
`EXC0001`	Failure in user KYC validation	KYC analysis rejected	Canceled
`EXC0002`	CPF/CNPJ not found	Person not found in the system	Validation
`EXC0003`	Account not found	Account not found with the provided data	Validation
`EXC0004`	Configuration error {0} for BusinessUnitId {1}	MatchingBusinessUnit not configured	Configuration
`EXC0005`	Unable to find Payer's account information	AccountHolder not found	Validation
`EXC0006`	Internal processing error	Internal system failure	Error
`EXC0007`	PIX Key blocked	Key blocked due to suspected fraud	Blocked
`EXC0008`	Recipient account blocked	Account blocked at the institution	Canceled
`EXC0009`	Unsupported key type	Invalid PIX key type	Validation
`EXC0010`	QR Code expired	QR Code beyond validity period	Expired
`EXC0018`	Please provide DocumentNumber, EndToEndId, or ConciliationId.	Required identifier not provided	Validation
`EXC0019`	Transaction not found with the provided data	PIX transaction not found or inconsistent data	Query
`EXC0023`	Receipt in processing. Please try again in a few moments.	Transaction in processing	Processing
`EXC0086`	Unable to perform the action due to restrictions on the use of Pix	Restrictions on Pix Key ownership	Validation

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