# 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. | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.gestao.plus/api/codigos_de_erro.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.