Errors

Card Not Present Verification uses conventional HTTP response codes to indicate the success or failure of an API request.

As a general rule:

Codes in the 2xx range indicate success with the request.
Codes in the 4xx range indicate incorrect or incomplete parameters (for example, a mandatory parameter was omitted, or an operation failed with third parties, etc.).
Codes in the 5xx range indicate an error on the Card Not Present Verification product servers.

Card Not Present Verification also generates an error message and an error code formatted in JSON:

{
    "error": {
        "code": "40004",
        "description": "transaction id is invalid"
    }
}

In this topic, you will find the possible errors for the endpoints, separated by their HTTP response.

HTTP Code	Code	Description	Reason
400	40001	error decoding json	The data sent does not match the service contract.
400	40002	error validating json	Some information is poorly formatted or missing.
400	40021	invalid phone	The provided phone number is invalid, it must follow the format: 55 DDD NUMBER. For example: 5543999999999.
400	40022	invalid email	The provided email is invalid.
400	40027	replicated transaction	The transaction sent already exists and cannot be created again.
400	40045	max value reached	When the transaction reaches a value higher than the allowed limit.
403	40301	not allowed	The user does not have permission to perform this action.
404	40404	company not found	The provided company does not exist.
429	40001	too many requests	Rate limit reached.
500	50001	internal error	Internal service failure.

HTTP Code	Code	Description	Reason
400	40001	error decoding json	The data sent does not match the service contract.
400	40002	error validating json	Some information is poorly formatted or missing.
400	40004	transaction id is invalid	The transaction ID is invalid (format).
400	40301	not allowed	The user does not have permission to perform this action.
429	40401	transaction not found	The transaction was not found.
500	50001	internal error	Internal service failure.

HTTP Code	Code	Description	Reason
400	40004	transaction id is invalid	The transaction ID is invalid (format).
400	40009	transaction status is invalid	The transaction status is invalid (not allowed for generating the proof set).
403	40301	not allowed	The user does not have permission to perform this action.
404	40401	transaction not found	The transaction was not found.
500	50001	internal error	Internal service failure.

HTTP Code	Code	Description	Reason
400	40001	error decoding json	The data sent does not match the service contract.
400	40002	error validating json	Some information is incorrectly formatted or has not been filled out.
400	40004	transaction id is invalid	The transaction ID is invalid (format).
400	40009	transaction status is invalid	The transaction status does not allow notification resend (it is already completed).
400	40021	invalid phone	The phone number provided is invalid, it must follow the format: 55 DDD NUMBER. For example: 5543999999999.
400	40022	invalid email	The provided email is invalid.
403	40301	not allowed	The user does not have permission to perform this action.
404	40401	transaction not found	The transaction was not found.
429	40001	too many requests	Rate limit reached.
500	50001	internal error	Rate limit reached.

HTTP Code	Code	Description	Reason
400	40001	error decoding json	The data sent does not match the service contract.
400	40002	error validating json	Some information is either incorrectly formatted or missing.
400	40027	replicated transaction	The submitted transaction already exists and cannot be created again.
400	40030	invalid identity	The CPF provided in the request differs from the CPF associated with the specified `processID`.
400	40045	max value reached	When the transaction exceeds the permitted amount.
400	40054	processID is invalid	When the `processID` provided in the request is invalid (or does not exist).
400	40055	processID is expired	When the `processID` being used is too old.
403	40301	not allowed	The user does not have permission to perform this action.
404	40404	company not found	The specified company does not exist.
404	40410	processID not found	When the specified process does not exist.
404	40412	image not found	When the process specified by the user does not have an image.
429	40001	too many requests	Rate limit reached.
429	42901	too many requests	When the client is sending too many requests, exceeding the predefined limit.
500	50001	internal error	Internal service failure.