Erros da API

Esses códigos são respostas à validação do conteúdo dos dados enviados no momento da requisição à API.

Se um código de erro for exibido, a requisição contém erros (como tamanho, condições ou erros de cadastro etc.) que impedem a criação da transação.

Exemplo

[
  {
    "Code": 126,
    "Message": "Credit Card Expiration Date is invalid"
  }
]
PropriedadeDescrição
CodeCódigo de Erro da API. Veja a lista de códigos
MessageDescrição do erro. Veja a lista de códigos

Códigos de Erros da API

Códigos retornados em caso de erro, identificando o motivo do erro e suas respectivas mensagens.

ReturnCodeReturnMessageDescrição
0Internal errorDado enviado excede o tamanho do campo
101MerchantId is requiredCampo enviado está vazio ou inválido
102Payment Type is requiredCampo enviado está vazio ou inválido
103Payment Type can only contain lettersCaracteres especiais não permitidos
104Customer Identity is requiredCampo enviado está vazio ou inválido
105Customer Name is requiredCampo enviado está vazio ou inválido
106Transaction ID is requiredCampo enviado está vazio ou inválido
107OrderId is invalid or does not existsCampo enviado excede o tamanho ou contem caracteres especiais
108Amount must be greater or equal to zeroValor da transação deve ser maior que "0"
109Payment Currency is requiredCampo enviado está vazio ou inválido
110Invalid Payment CurrencyCampo enviado está vazio ou inválido
111Payment Country is requiredCampo enviado está vazio ou inválido
112Invalid Payment CountryCampo enviado está vazio ou inválido
113Invalid Payment CodeCampo enviado está vazio ou inválido
114The provided MerchantId is not in correct formatO MerchantId enviado não é um GUID
115The provided MerchantId was not foundO MerchantID não existe ou pertence a outro ambiente (EX: Sandbox)
116The provided MerchantId is blockedLoja bloqueada, entre em contato com o suporte Cielo
117Credit Card Holder is requiredCampo enviado está vazio ou inválido
118Credit Card Number is requiredCampo enviado está vazio ou inválido
119At least one Payment is requiredNó "Payment" não enviado
120Request IP not allowed. Check your IP White ListIP bloqueado por questões de segurança
121Customer is requiredNó "Customer" não enviado
122MerchantOrderId is requiredCampo enviado está vazio ou inválido
123Installments must be greater or equal to oneNumero de parcelas deve ser superior a 1
124Credit Card is RequiredCampo enviado está vazio ou inválido
125Credit Card Expiration Date is requiredCampo enviado está vazio ou inválido
126Credit Card Expiration Date is invalidCampo enviado está vazio ou inválido
127You must provide CreditCard NumberNumero do cartão de crédito é obrigatório
128Card Number length exceededNumero do cartão superiro a 16 digitos
129Affiliation not foundMeio de pagamento não vinculado a loja ou Provider inválido
130Could not get Credit CardNão é possível encontrar um cartão pelo cardtoken enviado
131MerchantKey is requiredCampo enviado está vazio ou inválido
132MerchantKey is invalidO Merchantkey enviado não é um válido
133Provider is not supported for this Payment TypeProvider enviado não existe
134FingerPrint length exceededDado enviado excede o tamanho do campo
135MerchantDefinedFieldValue length exceededDado enviado excede o tamanho do campo
136ItemDataName length exceededDado enviado excede o tamanho do campo
137ItemDataSKU length exceededDado enviado excede o tamanho do campo
138PassengerDataName length exceededDado enviado excede o tamanho do campo
139PassengerDataStatus length exceededDado enviado excede o tamanho do campo
140PassengerDataEmail length exceededDado enviado excede o tamanho do campo
141PassengerDataPhone length exceededDado enviado excede o tamanho do campo
142TravelDataRoute length exceededDado enviado excede o tamanho do campo
143TravelDataJourneyType length exceededDado enviado excede o tamanho do campo
144TravelLegDataDestination length exceededDado enviado excede o tamanho do campo
145TravelLegDataOrigin length exceededDado enviado excede o tamanho do campo
146SecurityCode length exceededDado enviado excede o tamanho do campo
147Address Street length exceededDado enviado excede o tamanho do campo
148Address Number length exceededDado enviado excede o tamanho do campo
149Address Complement length exceededDado enviado excede o tamanho do campo
150Address ZipCode length exceededDado enviado excede o tamanho do campo
151Address City length exceededDado enviado excede o tamanho do campo
152Address State length exceededDado enviado excede o tamanho do campo
153Address Country length exceededDado enviado excede o tamanho do campo
154Address District length exceededDado enviado excede o tamanho do campo
155Customer Name length exceededDado enviado excede o tamanho do campo
156Customer Identity length exceededDado enviado excede o tamanho do campo
157Customer IdentityType length exceededDado enviado excede o tamanho do campo
158Customer Email length exceededDado enviado excede o tamanho do campo
159ExtraData Name length exceededDado enviado excede o tamanho do campo
160ExtraData Value length exceededDado enviado excede o tamanho do campo
161Boleto Instructions length exceededDado enviado excede o tamanho do campo
162Boleto Demostrative length exceededDado enviado excede o tamanho do campo
163Return Url is requiredURL de retorno não é valida - Não é aceito paginação ou extenções (EX .PHP) na URL de retorno
166AuthorizeNow is required***
167Antifraud not configuredAntifraude não vinculado ao cadastro do lojista
168Recurrent Payment not foundRecorrência não encontrada
169Recurrent Payment is not activeRecorrência não está ativa. Execução paralizada
170Cartão Protegido not configuredToken não vinculado ao cadastro do lojista
171Affiliation data not sentFalha no processamento do pedido - Entre em contato com o suporte Cielo
172Credential Code is requiredFalha na validação das credenciadas enviadas
173Payment method is not enabledMeio de pagamento não vinculado ao cadastro do lojista
174Card Number is requiredCampo enviado está vazio ou inválido
175EAN is requiredCampo enviado está vazio ou inválido
176Payment Currency is not supportedCampo enviado está vazio ou inválido
177Card Number is invalidCampo enviado está vazio ou inválido
178EAN is invalidCampo enviado está vazio ou inválido
179The max number of installments allowed for recurring payment is 1Campo enviado está vazio ou inválido
180The provided Card PaymentToken was not foundToken não encontrado
181The MerchantIdJustClick is not configuredToken bloqueado
182Brand is requiredBandeira do cartão não enviado
183Invalid customer bithdateData de nascimento inválida ou futura
184Request could not be emptyFalha no formado da requisição. Verifique o código enviado
185Brand is not supported by selected providerBandeira não suportada pela API Cielo
186The selected provider does not support the options provided (Capture, Authenticate, Recurrent or Installments)Meio de pagamento não suporta o comando enviado
187ExtraData Collection contains one or more duplicated names
188Avs with CPF invalid
189Avs with length of street exceeded
190Avs with length of number exceeded
191Avs with length of district exceeded
192Avs with zip code invalid
193Split Amount must be greater than zero
194Split Establishment is RequiredCampo enviado está vazio ou inválido
195The PlataformId is requiredCampo enviado está vazio ou inválido
196DeliveryAddress is requiredCampo enviado está vazio ou inválido
197Street is requiredCampo enviado está vazio ou inválido
198Number is requiredCampo enviado está vazio ou inválido
199ZipCode is requiredCampo enviado está vazio ou inválido
200City is requiredCampo enviado está vazio ou inválido
201State is requiredCampo enviado está vazio ou inválido
202District is requiredCampo enviado está vazio ou inválido
203Cart item Name is requiredCampo enviado está vazio ou inválido
204Cart item Quantity is requiredCampo enviado está vazio ou inválido
205Cart item type is requiredCampo enviado está vazio ou inválido
206Cart item name length exceeded
207Cart item description length exceeded
208Cart item sku length exceeded
209Shipping addressee sku length exceeded
210Shipping data cannot be null
211WalletKey is invalid
212Merchant Wallet Configuration not foundA Wallet utilizada não está habilitada, entre em contato com o suporte Cielo para habilitar.
213Credit Card Number is invalid
214Credit Card Holder Must Have Only Letters
215Agency is required in Boleto Credential
216Customer IP address is invalid
300MerchantId was not found
301Request IP is not allowedO serviço de restrição de IP pode estar habilitado e o IP informado não está configurado. Entre em contato com o suporte para habilitar o IP.
302Sent MerchantOrderId is duplicated
303Sent OrderId does not exist
304Customer Identity is requiredCampo enviado está vazio ou inválido
306Merchant is blockedMerchant está bloqueado
307Transaction not found
308Transaction not available to capture
309Transaction not available to void
310Payment method doest not support this operation
311Refund is not enabled for this merchant
312Transaction not available to refund
313Recurrent Payment not foundRecorrência não está habilitada, entre em contato com o suporte Cielo para habilitar.
314Invalid Integration
315Cannot change NextRecurrency with pending payment
316Cannot set NextRecurrency to past date
317Invalid Recurrency Day
318No transaction found
319Smart recurrency is not enabled
320Can not Update Affiliation Because this Recurrency not Affiliation saved
321Can not set EndDate to before next recurrency
322Zero Dollar Auth is not enabledO Zero Auth não está habilitado, entre em contato com o suporte Cielo para habilitar.
323Bin Query is not enabledA Consulta Bin não está habilitada, entre em contato com o suporte Cielo para habilitar.

Códigos de Motivo de Retorno

Reason CodeReason Message
0Successful
1AffiliationNotFound
2IssuficientFunds
3CouldNotGetCreditCard
4ConnectionWithAcquirerFailed
5InvalidTransactionType
6InvalidPaymentPlan
7Denied
8Scheduled
9Waiting
10Authenticated
11NotAuthenticated
12ProblemsWithCreditCard
13CardCanceled
14BlockedCreditCard
15CardExpired
16AbortedByFraud
17CouldNotAntifraud
18TryAgain
19InvalidAmount
20ProblemsWithIssuer
21InvalidCardNumber
22TimeOut
23CartaoProtegidoIsNotEnabled
24PaymentMethodIsNotEnabled
98InvalidRequest
99InternalError