Handling Errors

Fazz uses conventional HTTP response codes to indicate success or failure of an API request.

Codes in the 2xx range should indicate success.
Codes in the 4xx range should indicate an error that failed given the information provided.
Codes in the 5xx range should indicate an error with our servers.

Some 4xx errors that could be handled programmatically (e.g. bank declined payments) will include an error code that briefly explains the error reported.

Generic errors

Here is a list of possible error codes with details on how to resolve them.

Error code	Title	Description
001	Internal server error	This is rare. Contact us if you see this error in your response.
002	Access denied	You did not authenticate successfully for the API call you were trying to make. Please check your authentication credentials. See Authentication
003	Feature not supported	The functionality you are trying to use is not supported. Please check that the functionality is available for the locale or environment you are making the request to.
004	Record not found	The object you were looking for based on your API request parameters was not found. Please check the `id` that you've used for the request.
005	Invalid parameters	Your request parameters are invalid. Please check the format of your request parameters, or check that the parameters are within limits.
006	Unknown error	This is very rare. Please inform us if you receive such a response.
010	Service Temporarily Unavailable	Service is temporarily unavailable. Please try again after 10 minutes. Contact your account manager if you keep encountering this error.

Transaction errors

Error code	Title	Description
TXN0001	Account has insufficient funds	The account you are trying to perform a transaction from does not have enough funds. Make sure that a deposit is made to the account in order to proceed.
TXN0002	Invalid transaction amount	The transaction amount requested is either below the minimum, or above the maximum limits. Please check the limits of the transaction type you are trying to perform before re-trying.
TXN0003	Transaction exceeds account transaction limit	The transaction you are trying to perform will cause the account to exceed its transaction limits. The account will no longer be able to perform transactions until its limits are reset.
TXN0004	Transaction exceeds account balance limit	The transaction you are trying to perform will cause the receiving account to go past its account balance limits. The account will not be able to receive funds unless the amount will not cause it to exceed the account balance limit.
NM-001	Payer is not the same verified user.	The transaction is sent by a different individual. Hence, it is blocked. We will reach out to you to receive more documents from user to prove that the verified user is the payer.
FG-001	Transaction is under investigation.	The transaction is flagged by us internally for investigation.
EL-001	Amount exceeds limitations.	The transaction amount exceeds limit.
MA-001	Bank account is unverified.	The bank account used to make the transfer is unverified.