---
updatedAt: 2026-10-08T13:30:50.000Z
agentTools:
  siteIndex: https://docs.cielo.com.br/llms.txt
  projectIndex: https://docs.cielo.com.br/conecta/llms.txt
---

# Códigos de retorno

Define os códigos de retorno utilizados pela biblioteca **Client Conecta** para indicar o resultado da execução das operações.

Os códigos são retornados pela função ***RequestDispatcher*** e permitem à aplicação identificar o status da operação realizada.

## Códigos de retorno padrão

| Constante              | Valor | Descrição                                                                      |
| ---------------------- | ----- | ------------------------------------------------------------------------------ |
| CFL\_OK                | 0     | Operação realizada com sucesso.                                                |
| CFL\_ERROR\_INVOPER    | 1     | Código de operação inválida/não reconhecida.                                   |
| CFL\_ERROR\_INVPARAM   | 2     | Parâmetro inválido informado.                                                  |
| CFL\_ERROR\_MANDAT     | 3     | Parâmetro mandatório não informado.                                            |
| CFL\_ERROR\_INVCALL    | 4     | Chamada inválida à operação. Operações prévias são necessárias.                |
| CFL\_ERROR\_CANCEL     | 5     | Operação cancelada.                                                            |
| CFL\_ERROR\_TIMEOUT    | 6     | Esgotado o tempo máximo estipulado para a operação.                            |
| CFL\_ERROR\_NOTALLOWED | 7     | Operação não permitida.                                                        |
| CFL\_ERROR\_INVMODE    | 8     | Modo inválido.                                                                 |
| CFL\_ERROR\_EXECERR    | 9     | Erro interno de execução – problema de implementação da biblioteca (software). |

## Erros relacionados ao Pin Pad

| Constante                                | Valor | Descrição                                                                                                               |
| ---------------------------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------- |
| CFL\_ERROR\_PPC\_OPENERR                 | 10    | Erro no acesso ao pinpad - erro no comando de abertura da biblioteca do pinpad PPConecta.                               |
| CFL\_ERROR\_PPC\_EXECERR                 | 11    | Erro no acesso ao pinpad - erro interno de execução da biblioteca do pinpad PPConecta.                                  |
| CFL\_ERROR\_PPC\_PORTERR                 | 12    | Erro no acesso ao pinpad - porta serial utilizada para acesso ao pinpad inválida, provavelmente ocupada.                |
| CFL\_ERROR\_PPC\_COMMERR                 | 13    | Erro no acesso ao pinpad - falha ao encontrar o pinpad, provavelmente desconectado ou problemas com a interface serial. |
| CFL\_ERROR\_PPC\_COMMERR\_EXT            | 14    | Erro no acesso ao pinpad - erro na comunicação com o pinpad (status desconhecido, formato, timeout, proprietário).      |
| CFL\_ERROR\_PPC\_MCDATAERR               | 15    | Erro de leitura do cartão magnético.                                                                                    |
| CFL\_ERROR\_PPC\_ERRPIN                  | 16    | Erro na captura do pin ou na criptografia de dados, possível falta de chave(s) carregadas no pinpad.                    |
| CFL\_ERROR\_PPC\_NOCARD                  | 17    | Cartão não presente no leitor de cartão de chip.                                                                        |
| CFL\_ERROR\_PPC\_SECURITY                | 18    | Cartão não foi removido após a última transação realizada.                                                              |
| CFL\_ERROR\_PPC\_ERRCARD                 | 19    | Cartão com erro ou mal inserido.                                                                                        |
| CFL\_ERROR\_PPC\_CARDINV                 | 20    | Cartão inválido.                                                                                                        |
| CFL\_ERROR\_PPC\_CARDINVALIDAT           | 21    | Cartão invalidado.                                                                                                      |
| CFL\_ERROR\_PPC\_CARDAPPNAV              | 22    | Modo inválido.                                                                                                          |
| CFL\_ERROR\_PPC\_CARDAPPNAUT             | 23    | Cartão não aceito.                                                                                                      |
| CFL\_ERROR\_PPC\_INVAMOUNT               | 24    | Valor inválido.                                                                                                         |
| CFL\_ERROR\_PPC\_ERRMAXAID               | 25    | Número máximo de AIDs carregados superior ao permitido.                                                                 |
| CFL\_ERROR\_PPC\_ERRCARDBLOCKED          | 26    | Cartão bloqueado.                                                                                                       |
| CFL\_ERROR\_PPC\_CTLSSMULTIPLE           | 27    | Mais de um cartão contactless foi apresentado/aproximado ao leitor.                                                     |
| CFL\_ERROR\_PPC\_CTLSSINV                | 28    | Cartão contactless inválido.                                                                                            |
| CFL\_ERROR\_PPC\_CTLSSINVALIDAT          | 29    | Cartão contactless invalidado.                                                                                          |
| CFL\_ERROR\_PPC\_CTLSSAPPNAV             | 30    | Modo inválido.                                                                                                          |
| CFL\_ERROR\_PPC\_CTLSSAPPNAUT            | 31    | Cartão contactless não aceito.                                                                                          |
| CFL\_ERROR\_PPC\_MFERR                   | 32    | Erro com o arquivo de multimídia utilizado.                                                                             |
| CFL\_ERROR\_PPC\_LICENSEERR              | 33    | Erro com a licença do PPConecta.                                                                                        |
| CFL\_ERROR\_PRODUCT\_NOT\_IDENTIFIED     | 33    | Produto não identificado.                                                                                               |
| CFL\_ERROR\_AID\_PRODUCTID\_NOT\_FOUND   | 34    | Produto não encontrado para o AID informado.                                                                            |
| CFL\_ERROR\_ISSUER\_BIN\_PROCESS\_FAILED | 35    | Erro no processamento do BIN do emissor do produto.                                                                     |

## Intervalo reservado

| Valor   | Descrição                  |
| ------- | -------------------------- |
| 36 a 49 | Reservado para uso futuro. |

## Erros de configuração e processamento

| Constante                    | Valor | Descrição                                                 |
| ---------------------------- | ----- | --------------------------------------------------------- |
| CFL\_ERROR\_TRMID\_NOTCONFIG | 50    | Terminal ID não configurado.                              |
| CFL\_ERROR\_CNPJ             | 51    | CNPJ inválido.                                            |
| CFL\_ERROR\_CLIENTID         | 52    | ClientId inválido.                                        |
| CFL\_ERROR\_CLIENTSECRET     | 53    | ClientSecret inválido.                                    |
| CFL\_ERROR\_HASH\_CLIENT     | 54    | ClientId e/ou ClientSecret não conferem com o cadastrado. |
| CFL\_ERROR\_DATABASE         | 55    | Erro no acesso ao banco de dados.                         |
| CFL\_ERROR\_TOKEN            | 56    | Erro na geração do Token – Token não disponível.          |
| CFL\_ERROR\_MCH\_NFOUND      | 57    | Estabelecimento não cadastrado.                           |
| CFL\_ERROR\_TRMID            | 58    | Erro no cadastro do TerminalID.                           |

## Erros de integração e operação

| Constante                         | Valor | Descrição                                                                                                                  |
| --------------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------- |
| CFL\_ERROR\_NETWORK               | 59    | Erro na comunicação com o Cielo Conecta.                                                                                   |
| CFL\_ERROR\_TABLEPARAMETERS       | 60    | Erro na atualização dos parâmetros de operação.                                                                            |
| CFL\_ERROR\_PINPAD                | 61    | Erro no acesso ao pinpad.                                                                                                  |
| CFL\_ERROR\_NOT\_INIT             | 62    | Biblioteca Client Conecta não inicializada. Operação de Inicialização ainda não foi realizada com sucesso nesta instância. |
| CFL\_ERROR\_ERR\_INIT             | 63    | Erro na operação de inicialização da biblioteca do Client.                                                                 |
| CFL\_ERROR\_TRANS\_NFOUND         | 64    | Nenhuma transação encontrada para os dados informados.                                                                     |
| CFL\_ERROR\_CONECTA\_DATA\_MANDAT | 65    | Dado de resposta obrigatório não retornado pelo Cielo Conecta.                                                             |
| CFL\_ERROR\_PENDING\_TRANSACTION  | 66    | Transação com confirmação/desfazimento pendente.                                                                           |
| CFL\_ERROR\_ALREADY\_REFUND       | 67    | Transação já estornada.                                                                                                    |
| CFL\_ERROR\_TRANS\_NOT\_FOUND     | 68    | Transação não encontrada/disponível.                                                                                       |