Códigos de Erro

Mensagens de erro

Quando uma requisição de API falha, é retornado um código de resposta HTTP 4xx ou 5xx que identifica genericamente a falha, bem como uma resposta JSON que fornece informações mais específicas sobre o erro (ou os erros) que causou a falha.

A resposta conterá:

• O status e o status_code.

• O tipo e a categoria que você pode usar para programar as respostas aos erros.

• Uma mensagem legível para humanos que explica por que o erro ocorreu.

• Os valores possíveis para o parâmetro de tipo estão listados abaixo:

Status Code	Tipo	Categoria	Descrição	Código de erro Bandeira
500	processing_error	server_api_error	Ocorreu um erro de processamento.
409	invalid_request_error	duplicate_taxpayer_id	Customer with this taxpayer_id already exists.
408	invalid_request_error	service_request_timeout	Credit card process is temporarily unavailable at the specified location.
404	invalid_request_error	endpoint_not_found	The requested URL was not found on the server
401	invalid_request_error	authentication_failed	The API Key provided has expired or has been deleted.
401	invalid_request_error	expired_security_key	This API call cannot be made with a publishable API key.
401	invalid_request_error	invalid_key_for_api_call	The minimum amount is $0.50 (or equivalent in country currency). The amount must be a positive integer in cents representing how much to charge, e.g 1260 for $12.60.
400	invalid_request_error	transaction_amount_error	The minimum amount is $0.50 (or equivalent in country currency). The amount must be a positive integer in cents representing how much to charge, e.g 1260 for $12.60.
400	invalid_request_error	transfer_amount_error	The minimum transfer amount is $1.00 (or equivalent in country currency). The amount must be a positive integer in cents representing how much to charge, e.g 1260 for $12.60.
400	invalid_request_error	missing_required_param	Missing required parameter(s). Please verify request parameters.
400	invalid_request_error	unsupported_payment_type	Invalid request: unsupported payment type.
400	invalid_request_error	invalid_payment_information	Invalid payment information. Please verify request parameters.
400	invalid_request_error	invalid_parameter	Invalid parameter(s). Your parameter value is incorrect. Please verify request parameters.
402	file_upload	file_size_too_large
402	invalid_request_error	insufficient_escrow_funds_error	Requested transfer exceeds remaining settled funds in escrow.
402	invalid_request_error	capture_transaction_error	The capture request failed. Transaction could not be captured.
402	invalid_request_error	no_action_taken	No action taken. Unable to back out prior transaction
402	invalid_request_error	seller_authorization_refused	Seller has not been authorized to charge credit cards. Complete activation to start processing payments.
402	invalid_request_error	void_transaction_error	The void request failed. Transaction could not be voided.
402	card_error	invalid_expiry_month	Invalid expiry month value. Please verify request parameters.
402	card_error	invalid_expiry_year	Invalid expiry year value. Please verify request parameters.
402	card_error	card_customer_not_associated	Transaction denied. No active card.
402	card_error	insufficient_funds_error	Requested credit exceeds remaining settled funds.	51
402	card_error	expired_card_error	The credit card has expired.	33
402	card_error	invalid_card_number	The card number is not a valid credit card number.	15
402	card_error	invalid_pin_code	Transaction denied. Invalid PIN code.	55
402	card_error	authorization_refused	Transação ilegal	58

Retorno da adquirente (CNP)

Código de retorno	Mensagem de retorno
0	Success.
101	Unauthorized. Problems on the card, contact the issuer.
102	Unauthorized. Check the situation of the store with the issuer.
103	Unauthorized. Please try again.
104	Unauthorized. Please try again.
105	Unauthorized. Restricted card.
106	Error in issuer processing. Please try again.
107	Unauthorized. Please try again.
108	Unauthorized. Value not allowed for this type of card.
109	Unauthorized. Nonexistent card.
110	Unauthorized. Transaction type not allowed for this card.
111	Unauthorized. Insufficient funds.
112	Unauthorized. Expiry date expired.
113	Unauthorized. Identified moderate risk by the issuer.
114	Unauthorized. The card does not belong to the payment network.
115	Unauthorized. Exceeded the limit of transactions allowed in the period.
116	Unauthorized. Please contact the Card Issuer.
117	Transaction not found.
118	Unauthorized. Card locked.
119	Unauthorized. Invalid security code.
120	Zero dollar transaction approved successfully.
121	Error processing. Please try again.
122	Transaction previously sent.
123	Unauthorized. Bearer requested the end of the recurrences in the issuer.
124	Unauthorized. Contact Rede.
170	Zero dollar transaction not allowed for this card.
172	transaction already captured.
174	Zero dollar transaction success.
175	Zero dollar transaction denied.