# Códigos de erro (/docs/cartao/error-codes)
Códigos de retorno fornecidos pela adquirente em casos de erro, identificando o motivo da falha. Na API de cartão eles são expostos nos campos `returnCode` e `returnMessage` da cobrança; na documentação da adquirente esses mesmos campos aparecem como `ProviderReturnCode` e `ProviderReturnMessage`.
## Códigos da adquirente [#códigos-da-adquirente]
| Código (`returnCode`) | Mensagem (`returnMessage`) | Descrição |
| --------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 0 | Internal error | Dado enviado excede o tamanho do campo. |
| 100 | RequestId is required | Campo enviado está vazio ou inválido. |
| 101 | MerchantId is required | Campo enviado está vazio ou inválido. |
| 102 | Payment Type is required | Campo enviado está vazio ou inválido. |
| 103 | Payment Type can only contain letters | Caracteres especiais não permitidos. |
| 104 | Customer Identity is required | Campo enviado está vazio ou inválido. |
| 105 | Customer Name is required | Campo enviado está vazio ou inválido. |
| 106 | Transaction ID is required | Campo enviado está vazio ou inválido. |
| 107 | OrderId is invalid or does not exist | Campo enviado excede o tamanho ou contém caracteres especiais. |
| 108 | Amount must be greater or equal to zero | Valor da transação deve ser maior ou igual a "0". |
| 109 | Payment Currency is required | Campo enviado está vazio ou inválido. |
| 110 | Invalid Payment Currency | Campo enviado está vazio ou inválido. |
| 111 | Payment Country is required | Campo enviado está vazio ou inválido. |
| 112 | Invalid Payment Country | Campo enviado está vazio ou inválido. |
| 113 | Invalid Payment Code | Campo enviado está vazio ou inválido. |
| 114 | The provided MerchantId is not in correct format | O MerchantId enviado não é um GUID. |
| 115 | The provided MerchantId was not found | O MerchantId não existe ou pertence a outro ambiente (ex.: sandbox). |
| 116 | The provided MerchantId is blocked | Loja bloqueada, entre em contato com o suporte e-commerce. |
| 117 | Credit Card Holder is required | Campo enviado está vazio ou inválido. |
| 118 | Credit Card Number is required | Campo enviado está vazio ou inválido. |
| 119 | At least one Payment is required | Nó Payment não enviado. |
| 120 | Request IP not allowed. Check your IP White List | IP bloqueado por questões de segurança. |
| 121 | Customer is required | Nó Customer não enviado. |
| 122 | MerchantOrderId is required | Campo enviado está vazio ou inválido. |
| 123 | Installments must be greater or equal to one | Número de parcelas deve ser maior ou igual a 1. |
| 124 | Credit Card is Required | Campo enviado está vazio ou inválido. |
| 125 | Credit Card Expiration Date is required | Campo enviado está vazio ou inválido. |
| 126 | Credit Card Expiration Date is invalid | Campo enviado está vazio ou inválido. |
| 127 | You must provide CreditCard Number | Número do cartão de crédito é obrigatório. |
| 128 | Card Number length exceeded | Número do cartão superior a 16 dígitos. |
| 129 | Affiliation not found | Meio de pagamento não vinculado à loja ou Provider inválido. |
| 130 | Could not get Credit Card | \*\*\* |
| 131 | MerchantKey is required | Campo enviado está vazio ou inválido. |
| 132 | MerchantKey is invalid | O MerchantKey enviado não é válido. |
| 133 | Provider is not supported for this Payment Type | Provider enviado não existe. |
| 134 | FingerPrint length exceeded | Dado enviado excede o tamanho do campo. |
| 135 | MerchantDefinedFieldValue length exceeded | Dado enviado excede o tamanho do campo. |
| 136 | ItemDataName length exceeded | Dado enviado excede o tamanho do campo. |
| 137 | ItemDataSKU length exceeded | Dado enviado excede o tamanho do campo. |
| 138 | PassengerDataName length exceeded | Dado enviado excede o tamanho do campo. |
| 139 | PassengerDataStatus length exceeded | Dado enviado excede o tamanho do campo. |
| 140 | PassengerDataEmail length exceeded | Dado enviado excede o tamanho do campo. |
| 141 | PassengerDataPhone length exceeded | Dado enviado excede o tamanho do campo. |
| 142 | TravelDataRoute length exceeded | Dado enviado excede o tamanho do campo. |
| 143 | TravelDataJourneyType length exceeded | Dado enviado excede o tamanho do campo. |
| 144 | TravelLegDataDestination length exceeded | Dado enviado excede o tamanho do campo. |
| 145 | TravelLegDataOrigin length exceeded | Dado enviado excede o tamanho do campo. |
| 146 | SecurityCode length exceeded | Dado enviado excede o tamanho do campo. |
| 147 | Address Street length exceeded | Dado enviado excede o tamanho do campo. |
| 148 | Address Number length exceeded | Dado enviado excede o tamanho do campo. |
| 149 | Address Complement length exceeded | Dado enviado excede o tamanho do campo. |
| 150 | Address ZipCode length exceeded | Dado enviado excede o tamanho do campo. |
| 151 | Address City length exceeded | Dado enviado excede o tamanho do campo. |
| 152 | Address State length exceeded | Dado enviado excede o tamanho do campo. |
| 153 | Address Country length exceeded | Dado enviado excede o tamanho do campo. |
| 154 | Address District length exceeded | Dado enviado excede o tamanho do campo. |
| 155 | Customer Name length exceeded | Dado enviado excede o tamanho do campo. |
| 156 | Customer Identity length exceeded | Dado enviado excede o tamanho do campo. |
| 157 | Customer IdentityType length exceeded | Dado enviado excede o tamanho do campo. |
| 158 | Customer Email length exceeded | Dado enviado excede o tamanho do campo. |
| 159 | ExtraData Name length exceeded | Dado enviado excede o tamanho do campo. |
| 160 | ExtraData Value length exceeded | Dado enviado excede o tamanho do campo. |
| 161 | Boleto Instructions length exceeded | Dado enviado excede o tamanho do campo. |
| 162 | Boleto Demostrative length exceeded | Dado enviado excede o tamanho do campo. |
| 163 | Return Url is required | URL de retorno não é válida. Não são aceitas paginação ou extensões (ex.: PHP) na URL de retorno. |
| 166 | AuthorizeNow is required | \*\*\* |
| 167 | Antifraud not configured | Antifraude não vinculado ao cadastro do lojista. |
| 168 | Recurrent Payment not found | Recorrência não encontrada. |
| 169 | Recurrent Payment is not active | Recorrência não está ativa. Execução paralisada. |
| 170 | Cartão Protegido not configured | Cartão protegido não vinculado ao cadastro do lojista. |
| 171 | Affiliation data not sent | Falha no processamento do pedido, entre em contato com o suporte e-commerce. |
| 172 | Credential Code is required | Falha na validação das credenciadas enviadas. |
| 173 | Payment method is not enabled | Meio de pagamento não vinculado ao cadastro do lojista. |
| 174 | Card Number is required | Campo enviado está vazio ou inválido. |
| 175 | EAN is required | Campo enviado está vazio ou inválido. |
| 176 | Payment Currency is not supported | Campo enviado está vazio ou inválido. |
| 177 | Card Number is invalid | Campo enviado está vazio ou inválido. |
| 178 | EAN is invalid | Campo enviado está vazio ou inválido. |
| 179 | The max number of installments allowed for recurring payment is 1 | Campo enviado está vazio ou inválido. |
| 180 | The provided Card PaymentToken was not found | Token do cartão protegido não encontrado. |
| 181 | The MerchantIdJustClick is not configured | Token do cartão protegido bloqueado. |
| 182 | Brand is required | Bandeira do cartão não enviada. |
| 183 | Invalid customer bithdate | Data de nascimento inválida ou futura. |
| 184 | Request could not be empty | Falha no formato da requisição. Verifique o código enviado. |
| 185 | Brand is not supported by selected provider | Bandeira não suportada pela API Gateway de Pagamento. |
| 186 | The selected provider does not support the options provided (Capture, Authenticate, Recurrent or Installments) | Meio de pagamento não suporta o comando enviado. |
| 187 | ExtraData Collection contains one or more duplicated names | \*\*\* |
| 188 | Avs with CPF invalid | \*\*\* |
| 189 | Avs with length of street exceeded | Dado enviado excede o tamanho do campo. |
| 190 | Avs with length of number/complement exceeded | Dado enviado excede o tamanho do campo (número ou complemento do endereço). |
| 191 | Avs with length of district exceeded | Dado enviado excede o tamanho do campo. |
| 192 | Avs with zip code invalid | CEP enviado é inválido. |
| 193 | Split Amount must be greater than zero | Valor para realização do SPLIT deve ser superior a 0. |
| 194 | Split Establishment is Required | SPLIT não habilitado para o cadastro da loja. |
| 195 | PlatformId is required | Validador de plataformas não enviado. |
| 196 | DeliveryAddress is required | Campo obrigatório não enviado. |
| 197 | Street is required | Campo obrigatório não enviado. |
| 198 | Number is required | Campo obrigatório não enviado. |
| 199 | ZipCode is required | Campo obrigatório não enviado. |
| 200 | City is required | Campo obrigatório não enviado. |
| 201 | State is required | Campo obrigatório não enviado. |
| 202 | District is required | Campo obrigatório não enviado. |
| 203 | Cart item name is required | Campo obrigatório não enviado. |
| 204 | Cart item quantity is required | Campo obrigatório não enviado. |
| 205 | Cart item type is required | Campo obrigatório não enviado. |
| 206 | Cart item name length exceeded | Dado enviado excede o tamanho do campo. |
| 207 | Cart item description length exceeded | Dado enviado excede o tamanho do campo. |
| 208 | Cart item sku length exceeded | Dado enviado excede o tamanho do campo. |
| 209 | Shipping addressee sku length exceeded | Dado enviado excede o tamanho do campo. |
| 210 | Shipping data cannot be null | Campo obrigatório não enviado. |
| 213 | Credit Card Number is invalid | Cartão de crédito enviado é inválido. |
| 214 | Credit Card Holder Must Have Only Letters | Portador do cartão não deve conter caracteres especiais. |
| 215 | Agency is required in Boleto Credential | Campo obrigatório não enviado. |
| 216 | Customer IP address is invalid | IP bloqueado por questões de segurança. |
| 300 | MerchantId was not found | \*\*\* |
| 301 | Request IP is not allowed | \*\*\* |
| 302 | Sent MerchantOrderId is duplicated | Houve duplicidade do pedido. |
| 303 | Sent OrderId does not exist | \*\*\* |
| 304 | Customer Identity is required | \*\*\* |
| 306 | Merchant is blocked | \*\*\* |
| 307 | Transaction not found | Transação não encontrada ou não existente no ambiente. |
| 308 | Transaction not available to capture | Transação não pode ser capturada. Entre em contato com o suporte e-commerce.
\*Verificar se o valor informado é inferior ao valor total da transação ou se está disponível para captura |
| 309 | Transaction not available to void | Transação não pode ser cancelada. Entre em contato com o suporte e-commerce. |
| 310 | Payment method does not support this operation | Comando enviado não suportado pelo meio de pagamento. |
| 311 | Refund is not enabled for this merchant | Cancelamento após 24 horas não liberado para o lojista. |
| 312 | Transaction not available to refund | Transação não permite cancelamento após 24 horas. |
| 313 | Recurrent Payment not found | Transação recorrente não encontrada ou não disponível no ambiente. |
| 314 | Invalid Integration | \*\*\* |
| 315 | Cannot change NextRecurrency with pending payment | \*\*\* |
| 316 | Cannot set NextRecurrency to past date | Não é permitido alterar a data da recorrência para uma data passada. |
| 317 | Invalid Recurrency Day | \*\*\* |
| 318 | No transaction found | \*\*\* |
| 319 | Smart Recurrency is not enabled | Recorrência não vinculada ao cadastro do lojista. |
| 320 | Cannot Update Affiliation because this recurrency has no affiliation saved | \*\*\* |
| 321 | Cannot Set EndDate to before next recurrency | \*\*\* |
| 322 | Zero Dollar Auth is not enabled | Zero Dollar não vinculado ao cadastro do lojista. |
| 323 | Bin Query is not enabled | Consulta de Bins não vinculada ao cadastro do lojista. |
## Outros códigos de erro [#outros-códigos-de-erro]
Os códigos a seguir são retornados em casos de falha na comunicação entre a API e a adquirente (como timeouts) ou devido a problemas na integração.
Em caso de falha de comunicação com a adquirente, a transação pode ainda assim ter sido aprovada, e o status é reconciliado automaticamente depois. Para receber a atualização, cadastre uma URL de notificação de mudança de status ou consulte o status pela API.
Abaixo, alguns dos códigos retornados:
| Código | Significado |
| ------ | ----------------------------------------------------------------------------------------------------------- |
| BP171 | Rejeitado por risco de fraude (Velocity) |
| BP335 | Cancelado por erro transacional no Split de Pagamento |
| BP900 | Falha na operação |
| BP901 | Falha na operação |
| BP902 | Espere pela resposta da operação anterior (também documentado como "Aguarde resposta da operação anterior") |
| BP903 | Falha no cancelamento |
| BP904 | Falha na consulta |
Códigos BP são retornados pela adquirente; em caso de divergência confirme com o suporte.