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. |
Updated about 9 hours ago
Did this page help you?