Todas as funções da biblioteca, independentemente do que fazem, possuem o mesmo tipo padronizado de código retorno, conforme a tabela a seguir:
| Constante | Valor | Descrição |
|---|
| PPC_OK | 0 | Operação efetuada com sucesso – parâmetros de retorno contêm dados válidos. |
| PPC_PROCESSING | 1 | Em processamento, função deve ser chamada novamente. |
| PPC_NOTIFY | 2 | Em processamento, mensagem de notificação disponível. |
| 3 | Uso interno. |
| PPC_F1 | 4 | Pressionada tecla de função #1. |
| PPC_F2 | 5 | Pressionada tecla de função #2. |
| PPC_F3 | 6 | Pressionada tecla de função #3. |
| PPC_F4 | 7 | Pressionada tecla de função #4. |
| PPC_BACKSP | 8 | Pressionada tecla de apagar (backspace). |
| 9 | Uso interno. |
| Constante | Valor | Descrição |
|---|
| PPC_INVCALL | 10 | Chamada inválida à função. Operações prévias são necessárias. |
| PPC_INVPARM | 11 | Parâmetro inválido passado à função. |
| PPC_TIMEOUT | 12 | Esgotado o tempo máximo estipulado para a operação. |
| PPC_CANCEL | 13 | Operação cancelada pelo operador. |
| PPC_ALREADYOPEN | 14 | Biblioteca já "aberta". Deixou de retornar este erro. Caso a comunicação já tenha sido aberta e esteja "ativa", retorna PPC_OK. |
| PPC_NOTOPEN | 15 | Biblioteca não foi "aberta". |
| PPC_EXECERR | 16 | Erro interno de execução – problema de implementação da biblioteca (software). |
| PPC_INVMODEL | 17 | Função não suportada. |
| PPC_NOFUNC | 18 | Função não disponível. |
| PPC_ERRMANDAT | 19 | Um parâmetro mandatório não foi fornecido. |
| PPC_TABEXP | 20 | A versão das tabelas carregadas no pinpad difere da versão apresentada. |
| PPC_TABERR | 21 | Erro ao tentar gravar tabelas (falta de espaço, por exemplo). |
| 22 a 27 | Reservado para uso futuro. |
| PPC_DATNFOUND | 28 | Dado de resposta não foi encontrado. |
| PPC_INVREF | 29 | Referência desconhecida de parâmetro de entrada ou dado de resposta. |
| Constante | Valor | Descrição |
|---|
| PPC_PORTERR | 30 | Erro de comunicação: porta serial do pinpad provavelmente ocupada. |
| PPC_COMMERR | 31 | Erro de comunicação: pinpad provavelmente desconectado ou problemas com a interface serial. |
| PPC_UNKNOWNSTAT | 32 | Status informado pelo pinpad não é conhecido. |
| PPC_RSPERR | 33 | Mensagem recebida do pinpad possui formato inválido. |
| PPC_COMMTOUT | 34 | Tempo esgotado ao esperar pela resposta do pinpad (no caso de comandos não blocantes). |
| 35 a 39 | Reservado para uso futuro. |
| Constante | Valor | Descrição |
|---|
| PPC_INTERR | 40 | Erro interno do pinpad. |
| PPC_MCDATAERR | 41 | Erro de leitura do cartão magnético. |
| PPC_ERRPIN | 42 | Erro na captura do PIN - Master Key pode não estar presente. |
| PPC_NOCARD | 43 | Não há cartão com chip presente no acoplador. |
| PPC_PINBUSY | 44 | Terminal não pode processar a captura de PIN temporariamente devido a questões de segurança (como quando é atingido o limite de capturas dentro de um intervalo de tempo). |
| PPC_RSPOVRFL | 45 | Montagem dos dados de resposta supera o tamanho máximo permitido. |
| 46 a 49 | Reservado para uso futuro. |
| Constante | Valor | Descrição |
|---|
| PPC_SAMERR | 50 | Erro genérico no módulo SAM. |
| PPC_NOSAM | 51 | SAM ausente, "mudo", ou com erro de comunicação. |
| PPC_SAMINV | 52 | SAM inválido, desconhecido ou com problemas. |
| 53 a 59 | Reservado para uso futuro. |
| Constante | Valor | Descrição |
|---|
| PPC_DUMBCARD | 60 | Cartão não responde ("mudo") ou chip não presente. |
| PPC_ERRCARD | 61 | Erro de comunicação do terminal com o cartão com chip. |
| PPC_CARDINV | 62 | Cartão do tipo inválido ou desconhecido, não pode ser tratado. |
| 63 a 66 | Reservado para uso futuro. |
| PPC_CARDINVALIDAT | 67 | Cartão foi invalidado (Comando Select retornou status 6283). |
| PPC_CARDPROBLEMS | 68 | Cartão com problemas. Esse status é válido para muitas ocorrências no processamento de cartões EMV onde o cartão não se comporta conforme o esperado e a transação deve ser finalizada. |
| PPC_CARDINVDATA | 69 | O cartão se comporta corretamente, porém possui dados inválidos ou inconsistentes. |
| PPC_CARDAPPNAV | 70 | Cartão sem nenhuma aplicação disponível para as condições pedidas. |
| PPC_CARDAPPNAUT | 71 | Somente para cartão EMV. A aplicação selecionada não pode ser utilizada (o Get Processing Options retornou status 6985 ou houve erro no comando Select final), e não há outra aplicação compatível na lista de candidatas. |
| 72 a 76 | Uso interno. |
| PPC_INVAMOUNT | 77 | Valor inválido para a transação. |
| PPC_ERRMAXAID | 78 | Número de AIDs candidatos supera a capacidade de tratamento do Kernel EMV. |
| PPC_CARDBLOCKED | 79 | Cartão está bloqueado (Comando Select retornou status 6A81). |
| Constante | Valor | Descrição |
|---|
| PPC_CTLSSMULTIPLE | 80 | Mais de um cartão sem contato foi apresentado ao leitor (este código de retorno é opcional e depende da capacidade do equipamento em detectar esta situação). |
| PPC_CTLSSCOMMERR | 81 | Erro de comunicação entre o terminal (antena) e o cartão com chip sem contato. |
| PPC_CTLSSINVALIDAT | 82 | Cartão foi invalidado (seleção de aplicação retornou status 6A81). |
| PPC_CTLSSPROBLEMS | 83 | Cartão com problemas. Esse status é válido para muitas ocorrências no processamento de cartões sem contato em que o cartão não se comporta conforme o esperado e a transação deve ser finalizada. |
| PPC_CTLSSAPPNAV | 84 | Cartão sem nenhuma aplicação disponível para as condições pedidas (nenhum AID encontrado). |
| PPC_CTLSSAPPNAUT | 85 | A aplicação selecionada não pode ser utilizada (o Get Processing Options retornou status 6985 ou houve erro no comando Select final), e não há outra aplicação compatível na lista de candidatas. Para cartão Mifare, este código possui diferentes significados relacionados à segurança (ver comandos). |
| 86 e 87 | Uso interno. |
| 88 a 99 | Reservado para uso futuro. |
| Constante | Valor | Descrição |
|---|
| PPC_MFNFOUND | 100 | Arquivo multimídia não encontrado no pinpad. |
| PPC_MFERRFMT | 101 | Erro no formato do arquivo multimídia. |
| PPC_MFERR | 102 | Erro na carga do arquivo multimídia. |
| PPC_MFSRCNFOUND | 110 | Arquivo multimídia não encontrado no PC. |
| 111 a 119 | Reservado para uso futuro. |
| Constante | Valor | Descrição |
|---|
| PPC_SW_WARNING | 120 | Código de erro máximo para códigos de aviso (warning) SW. |
| PPC_SW_FILEINVALIDATED | 121 | Arquivo inválido. |
| PPC_SW_AUTHFAILED | 122 | Falha na autenticação. |
| PPC_SW_COUNTER_MAX | 123 | Máximo valor do contador. |
| PPC_SW_COUNTER_MIN | 124 | Mínimo valor do contador. |
| PPC_SW_WARNING_OTHER | 125 | Ponto de atenção da camada SW. |
| PPC_SW_WARNING_MIN | 126 | Código de erro mínimo para códigos de aviso (warning) SW. |
| PPC_SW_ABORT_MAX | 127 | Código de erro máximo para códigos de aviso (warning) SW. |
| 128 | Reservado para uso futuro. |
| PPC_SW_AUTHBLOCKED | 129 | Método de autenticação bloqueado. |
| PPC_SW_DATAINVALIDATED | 130 | Dados inválidos. |
| PPC_SW_CONDNOTSATISFIED | 131 | Pré-requisitos de uso não atendidos. |
| PPC_SW_FUNCTIONNOTSUPPORTED | 132 | Função não suportada. |
| PPC_SW_FILENOTFOUND | 133 | Arquivo não encontrado. |
| PPC_SW_RECORDNOTFOUND | 134 | Registro não encontrado. |
| PPC_SW_DATANOTFOUND | 135 | Dados não encontrados. |
| PPC_SW_ABORT_OTHER | 136 | Outra função de abort da camada SW. |
| PPC_SW_ABORT_MIN | 137 | Código mínimo de abort das funções SW. |
| 138 e 139 | Reservados para uso futuro. |
| PPC_SW_MIN | 140 | Código mínimo para funções SW. |
| 141 a 199 | Reservados para uso futuro. |
| Constante | Valor | Descrição |
|---|
| PPC_INVLICENSE | 200 | Código de licença inválido. |
| PPC_INVCOMPANY | 201 | Nome da empresa incompatível com licença. |
| PPC_EXPLICENSE | 202 | Licença expirada. |
| Constante | Valor | Descrição |
|---|
| PPC_NOTIFY_DSP | 1001 | Notificação para mensagem de display do pin pad. |
| PPC_NOTIFY_MNU | 1002 | Notificação para apresentação de menu de seleção de aplicação (comando PPC_CMD_GETCARD). |
| PPC_NOTIFY_PIN | 1003 | Notificação indicando quantos dígitos de PIN estão sendo capturados (comandos PPC_CMD_GETPIN e PPC_CMD_PROCCHIP). |
