11. Códigos de retorno

11.1 Códigos de Retorno da PGWebLib

A tabela abaixo descreve os possíveis códigos de retorno das diversas funções da biblioteca:

ConstanteCódigoDescrição
PWRET_OK0Operação bem-sucedida.
PWRET_FROMHOSTPENDTRN-2599Existe uma transação pendente, é necessário confirmar ou desfazer essa transação através de PW_iConfirmation.
PWRET_FROMHOSTPOSAUTHERR-2598Falha de autenticação do ponto de captura com a infraestrutura do PayGo.
PWRET_FROMHOSTUSRAUTHERR-2597Falha de autenticação do usuário.
PWRET_FROMHOST-2596Erro retornado pela infraestrutura do PayGo. Verificar a mensagem (PWINFO_RESULTMSG) para mais informações.
PWRET_TLVERR-2595Falha de comunicação com a infraestrutura do PayGo (codificação da mensagem).
PWRET_SRVINVPARAM-2594Falha de comunicação com a infraestrutura do PayGo (parâmetro inválido).
PWRET_REQPARAM-2593Falha de comunicação com a infraestrutura do PayGo (falta parâmetro obrigatório).
PWRET_HOSTCONNUNK-2592Erro interno da biblioteca (conexão ao host).
PWRET_INTERNALERR-2591Erro interno da biblioteca.
PWRET_BLOCKED-2590O ponto de captura foi bloqueado para uso.
PWRET_FROMHOSTTRNNFOUND-2589A transação referenciada (cancelamento, confirmação, etc.) não foi encontrada.
PWRET_PARAMSFILEERR-2588Inconsistência dos parâmetros de operação recebidos da infraestrutura do PayGo.
PWRET_NOCARDENTMODE-2587O Ponto de Captura não tem a capacidade de efetuar a captura do cartão através dos tipos de entrada especificados pelo PayGo.
PWRET_INVALIDVIRTMERCH-2586Falha de comunicação com a infraestrutura do PayGo (código de afiliação inválido).
PWRET_HOSTTIMEOUT-2585Falha de comunicação com a infraestrutura do PayGo (tempo de resposta esgotado).
PWRET_CONFIGREQUIRED-2584Erro de configuração. É necessário acionar a função de configuração.
PWRET_HOSTCONNERR-2583Falha de conexão à infraestrutura do PayGo.
PWRET_HOSTCONNLOST-2582A conexão com a infraestrutura do PayGo foi interrompida.
PWRET_FILEERR-2581Falha no acesso aos arquivos da biblioteca de integração.
PWRET_PINPADERR-2580Falha de comunicação com o pinpad (aplicação).
PWRET_MAGSTRIPEERR-2579Formato de tarja magnética não reconhecido.
PWRET_PPCRYPTERR-2578Falha de comunicação com o pinpad (comunicação segura).
PWRET_SSLCERTERR-2577Falha no certificado SSL.
PWRET_SSLNCONN-2576Falha ao tentar estabelecer conexão SSL.
PWRET_GPRSATTACHFAILED-2575Falha no registro GPRS.
PWRET_EMVDENIEDCARD-2574Transação EMV negada pelo cartão.
PWRET_EMVDENIEDHOST-2573Transação EMV negada pelo host.
PWRET_NOLINE-2572Sem tom de linha.
PWRET_NOANSWER-2571Sem resposta (Linha não atende).
PWRET_SYNCERROR-2570Falha de sincronismo.
PWRET_CRCERR-2569Falha no CRC da mensagem.
PWRET_DECOMPERR-2568Falha na descompressão da mensagem.
PWRET_PROTERR-2567Falha no protocolo de conexão.
PWRET_NOSIM-2566SIM Card não encontrado.
PWRET_SIMERROR-2565Erro no SIM Card.
PWRET_SIMBLOCKED-2564SIM Card está bloqueado.
PWRET_PPPNEGFAILED-2563Falha na autenticação PPP.
PWRET_WIFICONNERR-2562Falha de comunicação WiFi.
PWRET_WIFINOTFOUND-2561Falha rede WiFi não encontrada.
PWRET_COMPERR-2560Falha na compactação da mensagem.
PWRET_INVALIDCPFCNPJ-2559Erro CPF ou CNPJ inválido.
PWRET_APNERROR-2558Erro de falha na APN do SIM Card.
PWRET_WIFIAUTHERROR-2557Erro na autenticação da rede WIFi.
PWRET_QRCODEERR-2556Erro no processamento do QR Code.
PWRET_QRCODENOTSUPPORTED-2555Erro QR Code não suportado pelo terminal.
PWRET_QRCODENOTFOUND-2554Erro QR Code não encontrado.
PWRET_DEFAULT_COMM_ERROR-2553Erro genérico de comunicação.
PWRET_
CTLSMAGSTRIPENOTALLOW
-2552Aplicação não permite fallback contactless.
PWRET_PARAMSFILEERRSIZE-2551Erro de tamanho do arquivo de parâmetros.
PWRET_INVPARAM-2499Parâmetro inválido passado à função.
PWRET_NOTINST-2498Ponto de Captura não instalado. É necessário acionar a função de Instalação.
PWRET_MOREDATA-2497Ainda existem dados que precisam ser capturados para a transação poder ser realizada.
PWRET_NODATA-2496A informação solicitada não está disponível.
PWRET_DISPLAY-2495A Automação deve apresentar uma mensagem para o operador.
PWRET_INVCALL-2494Função chamada no momento incorreto.
PWRET_NOTHING-2493Nada a fazer, continuar o processamento.
PWRET_BUFOVFLW-2492O tamanho da área de memória informado é insuficiente.
PWRET_CANCEL-2491Operação cancelada pelo operador.
PWRET_TIMEOUT-2490Tempo limite excedido para ação do operador.
PWRET_PPNOTFOUND-2489pinpad não encontrado na busca efetuada.
PWRET_TRNNOTINIT-2488Não foi chamada a função PW_iNewTransac.
PWRET_DLLNOTINIT-2487Não foi chamada a função PW_iInit.
PWRET_FALLBACK-2486Ocorreu um erro no cartão magnético, passar a aceitar o cartão digitado, caso já não esteja sendo aceito.
PWRET_WRITERR-2485Falha de gravação no diretório de trabalho.
PWRET_PPCOMERR-2484Falha na comunicação com o pinpad (protocolo).
PWRET_NOMANDATORY-2483Algum dos parâmetros obrigatórios não foi adicionado.
PWRET_OFFINTERNAL-2482Falha onde verifica se a transação ká foi selecionada.
PWRET_OFFINVCAP-2481Falha onde contenha um número diferente de itens de menu e texto a exibir.
PWRET_OFFNOCARDENTMODE-2480Falha caso não tenha nenhum meio de captura habilitado.
PWRET_OFFINVCARDENTMODE-2479Falha onde o meio de captura utilizado não esteja habilitado.
PWRET_OFFNOTABLECARDRANGE-2478Falha quando não existir tabela de cartão para o range inserido.
PWRET_OFFNOTABLEPRODUCT-2477Falha quando não existir tabela de produto para a transação em execução.
PWRET_OFFINVTAG-2476Falha de Tag inválida.
PWRET_OFFNOCARDFULLPAN-2475Falha obtendo o número do cartão.
PWRET_OFFINVCARDEXPDT-2474Falha de data de validade do cartão inválida.
PWRET_OFFCARDEXP-2473Falha cartão expirado.
PWRET_OFFNOTRACKS-2472Falha cartão sem trilha.
PWRET_OFFTRACKERR-2471Falha erro na leitura da trilha do cartão.
PWRET_OFFCHIPMANDATORY-2470Falha transação com chip é mandatória.
PWRET_OFFINVCARD-2469Falha cartão inválido.
PWRET_OFFINVCURR-2468Falha moeda inválida.
PWRET_OFFINVAMOUNT-2467Falha valor inválido.
PWRET_OFFGREATERAMNT-2466Falha valor excede o máximo permitido.
PWRET_OFFLOWERAMNT-2465Falha valor não atinge o mínimo permitido.
PWRET_OFFGREATERINST-2464Falha valor da parcela excede o valor permitido.
PWRET_OFFLOWERINST-2463Falha valor da parcela não atinge o mínimo permitido.
PWRET_OFFINVCARDTYPE-2462Falha tipo de cartão inválido.
PWRET_OFFINVFINTYPE-2461Falha tipo de financiamento inválido.
PWRET_OFFINVINST-2460Falha número de parcelas inválida.
PWRET_OFFGREATERINSTNUM-2459Falha número de parcelas excede o máximo permitido.
PWRET_OFFLOWERINSTNUM-2458Falha número de parcelas não atinge o mínimo permitido.
PWRET_OFFMANDATORYCVV-2457Falha código de segurança do cartão obrigatório.
PWRET_OFFINVLASTFOUR-2456Falha 4 últimos dígitos do cartão inválidos.
PWRET_OFFNOAID-2455Falha AID do cartão não se encontra nas tabelas de inicialização.
PWRET_OFFNOFALLBACK-2454Falha fallback não permitido.
PWRET_OFFNOPINPAD-2453Falha PIN-Pad não encontrado.
PWRET_OFFNOAPOFF-2452Falha transação offline não permitida.
PWRET_OFFTRNNEEDPP-2451Falha transação necessita de pinpad.
PWRET_OFFCARDNACCEPT-2450Falha cartão não aceito.
PWRET_OFFTABLEERR-2449Falha nas tabelas de inicialização.
PWOFF_OFFMAXTABERR-2448Falha número de tabelas excede o máximo.
PWRET_OFFINTERNAL1-2447Falha caso exista mais do que uma tabela de produto para a transação em execução.
PWRET_OFFINTERNAL2-2446Falha caso exista mais do que uma tabela de produto para a transação em execução.
PWRET_OFFINTERNAL3-2445Falha caso não exista no buffer a tag MUXTAG_CARDFULLPAN.
PWRET_OFFINTERNAL4-2444Falha caso exista mais do que uma tabela de produto para a transação em execução.
PWRET_OFFINTERNAL5-2443Falha na recuperação de valor da tag MUXTAG_EMVRESOFF.
PWRET_OFFINTERNAL6-2442Falha caso exista mais do que uma tabela de produto para a transação em execução.
PWRET_OFFINTERNAL7-2441Falha caso exista mais do que uma tabela de produto para a transação em execução.
PWRET_OFFINTERNAL8-2440Falha na obtenção e validação da trilha 2.
PWRET_OFFINTERNAL9-2439Falha no tamanho da trilha 2 do cartão.
PWRET_OFFINTERNAL10-2438Falha na obtenção e validação da trilha 1.
PWRET_OFFINTERNAL11-2437Falha caso exista mais do que uma tabela de produto para a transação em execução.
PWRET_OFFNOPRODUCT-2436Falha para quando não existir produtos compatíveis nas tabelas para a transação em execução.
PWRET_OFFINTERNAL12-2435Falha na obtenção e validação do PAN do cartão.
PWRET_OFFINTERNAL13-2434Falha na criptografia genérica da transação.
PWRET_OFFINTERNAL14-2433Falha na criptografia genérica da transação.
PWRET_NOPINPAD-2432Falha PIN-Pad não encontrado.
PWRET_OFFINTERNAL15-2431Falha na obtenção da informação de valor da parcela
PWRET_OFFINTERNAL16-2430Falha trilha do cartão fora do formato padrão.
PWRET_ABECSERRCOM-2429Falha PIN-Pad incompatível.
PWRET_OFFCFGNOCARDRANGE-2428Falha inconsistência nas informações de cartão recebidas.
PWRET_OFFCFGNOPRODUCT-2427Falha inconsistência nas informações de produto recebidas.
PWRET_OFFCFGNOTRANSACTION-2426Falha inconsistência nas informações de transação recebidas.
PWRET_OFFINTERNAL17-2425Falha na criptografia genérica da transação.
PWRET_OFFINTERNAL18-2424Falha processamento offline da PGWebLib.
PWRET_PPABORT -2423Falha abortar comando PIN-Pad.
PWRET_OFFINTERNAL19-2422Falha caso exista mais do que uma tabela de produto para a transação em execução.
PWRET_PPERRTREATMENT-2421Erro de tratamento PIN-Pad.
PWRET_INVPAYMENTMODE-2420Falha modalidade de pagamento inválida.
PWRET_OFFINVALIDOPER-2419Operação selecionada não está disponível.
PWRET_OFFINTERNAL20-2418Falha processamento offline tag EMV.
PWRET_OFFINTERNAL21-2417Erro processamento offline do QR Code.
PWRET_PPS_XXX-2200 até -2100Erros retornados pelo pinpad, conforme seção 11.2

11.2 Códigos de Retorno da biblioteca de pinpad

A tabela abaixo descreve os possíveis códigos de retorno da biblioteca de pinpad:

ConstanteCódigoDescrição
PWRET_PPS_OK-2100Operação efetuada com sucesso
PWRET_PPS_PROCESSING-2101Em processamento
PWRET_PPS_NOTIFY-2102Notificação de mensagem no checkout
PWRET_PPS_F1-2104Pressionada tecla de função #1.
PWRET_PPS_F2-2105Pressionada tecla de função #2.
PWRET_PPS_F3-2106Pressionada tecla de função #3.
PWRET_PPS_F4-2107Pressionada tecla de função #4.
PWRET_PPS_BACKSP-2108Pressionada tecla de apagar (backspace)
Status de 10 a 29 : Erros básicos da biblioteca
PWRET_PPS_INVCALL-2110Chamada inválida à função. Operações prévias são necessárias
PWRET_PPS_INVPARM-2111Parâmetro inválido passado a função.
PWRET_PPS_TIMEOUT-2112Esgotado o tempo máximo estipulado para a operação.
PWRET_PPS_CANCEL-2113Operação cancelada pelo operador.
PWRET_PPS_ALREADYOPEN-2114Pinpad já aberto.
PWRET_PPS_NOTOPEN-2115Pinpad não foi aberto.
PWRET_PPS_EXECERR-2116Erro interno de execução - problema de implementação da biblioteca (software).
PWRET_PPS_INVMODEL-2117Função não suportada pelo modelo de pinpad.
PWRET_PPS_NOFUNC-2118Função não disponível na Biblioteca do pinpad.
PWRET_PPS_TABEXP-2120Tabelas expiradas (pelo “timestamp”).
PWRET_PPS_TABERR-2121Erro ao tentar gravar tabelas (falta de espaço, por exemplo)
PWRET_PPS_NOAPPSLIC-2122Aplicação do Provedor não existe no pinpad.
-2123 até -2129Reservado para uso futuro
Status de 30 a 39 : Erros de comunicação/protocolo com o pinpad
PWRET_PPS_PORTERR-2130Erro de comunicação: porta serial do pinpad provavelmente ocupada
PWRET_PPS_COMMERR-2131Erro de comunicação: pinpad provavelmente desconectado ou problemas com a interface serial.
PWRET_PPS_UNKNOWNSTAT-2132Status informado pelo pinpad não é conhecido.
PWRET_PPS_RSPERR-2133Mensagem recebida do pinpad possui formato inválido.
PWRET_PPS_COMMTOUT-2134Tempo esgotado ao esperar pela resposta do pinpad (no caso de comandos não blocantes).
-2135 até -2139Reservado para uso futuro
Status de 40 a 49 : Erros básicos reportados pelo pinpad
PWRET_PPS_INTERR-2140Erro interno do pinpad.
PWRET_PPS_MCDATAERR-2141Erro de leitura do cartão magnético.
PWRET_PPS_ERRPIN-2142Erro na captura do PIN - Master Key pode não estar presente.
PWRET_PPS_NOCARD-2143Não há cartão com chip presente no acoplador.
PWRET_PPS_PINBUSY-2144Pinpad 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).
-2145 até -2149Reservado para uso futuro.
Status de 50 a 59 : Erros de processamento de cartão com chip (SAM)
PWRET_PPS_SAMERR-2150Erro genérico no módulo SAM.
PWRET_PPS_NOSAM-2151SAM ausente, “mudo”, ou com erro de comunicação.
PWRET_PPS_SAMINV-2152SAM inválido, desconhecido ou com problemas.
-2153 até -2159Reservado para uso futuro.
Status de 60 a 79 : Erros de processamento de cartão com chip com contato
PWRET_PPS_DUMBCARD-2160Cartão não responde (“mudo”) ou chip não presente.
PWRET_PPS_ERRCARD-2161Erro de comunicação do pinpad com o cartão com chip.
PWRET_PPS_CARDINV-2162Cartão do tipo inválido ou desconhecido, não pode ser tratado (não é EMV nem TIBC v1).
PWRET_PPS_CARDBLOCKED-2163Cartão bloqueado por número excessivo de senhas incorretas (somente para Easy-Entry TIBC v1 e moedeiro VISA Cash).
PWRET_PPS_CARDNAUTH-2164Cartão TIBC v1 não autenticado pelo módulo SAM (somente para Easy-Entry TIBC v1 e moedeiro VISA Cash).
PWRET_PPS_CARDEXPIRED-2165Cartão TIBC v1 expirado (somente para Easy-Entry TIBC v1 e moedeiro VISA Cash).
PWRET_PPS_CARDERRSTRUCT-2166Cartão com erro de estrutura - arquivos estão faltando.
PWRET_PPS_CARDINVALIDAT-2167Cartão foi invalidado. Se o cartão for TIBC v1, quando seleção de arquivo ou ATR retornar status ‘6284’. Se o cartão for EMV, quando seleção de aplicação retornar status ‘6A81’.
PWRET_PPS_CARDPROBLEMS-2168Cartão com problemas. Esse status é válido para muitas ocorrências no processamento de cartões TIBC v1 e EMV onde o cartão não se comporta conforme o esperado e a transação deve ser finalizada.
PWRET_PPS_CARDINVDATA-2169O cartão, seja TIBC v1 ou EMV, comporta-se corretamente porém possui dados inválidos ou inconsistentes.
PWRET_PPS_CARDAPPNAV-2170Cartão sem nenhuma aplicação disponível para as condições pedidas (ou cartão é reconhecido como TIBC v1 ou EMV mas não possui nenhuma aplicação compatível com a requerida).
PWRET_PPS_CARDAPPNAUT-2171Somente para cartão EMV. A aplicação selecionada não pode ser utilizada (o GetProcessingOptions retornou status ‘6985’ ou houve erro no comando Select final), e não há outra aplicação compatível na lista de candidatas.
PWRET_PPS_NOBALANCE-2172Somente para aplicação de moedeiro. O saldo do moedeiro é insuficiente para a operação.
PWRET_PPS_LIMITEXC-2173Somente para aplicação de moedeiro. O limite máximo para a operação foi excedido.
PWRET_PPS_CARDNOTEFFECT-2174Cartão ainda não efetivo, data de ativação posterior à data atual (somente para moedeiro VISA Cash sobre TIBCv3).
PWRET_PPS_VCINVCURR-2175Moeda inválida (somente para moedeiro VISA Cash).
PWRET_PPS_ERRFALLBACK-2176Erro de alto nível no cartão EMV que é passível de “fallback” para tarja magnética.
-2177 até -2179-2177 até
-2179
Status de 80 a 99 : Erros de processamento de cartão com chip sem contato
PWRET_PPS_CTLSSMULTIPLE-2180Mais 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).
PWRET_PPS_CTLSSCOMMERR-2181Erro de comunicação entre o terminal (antena) e o cartão com chip sem contato.
PWRET_PPS_CTLSSINVALIDAT-2182Cartão foi invalidado (seleção de aplicação retornou status ‘6A81’).
PWRET_PPS_CTLSSPROBLEMS-2183Cartã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.
PWRET_PPS_CTLSSAPPNAV-2184Cartão sem nenhuma aplicação disponível para as condições pedidas (nenhum AID encontrado).
PWRET_PPS_CTLSSAPPNAUT-2185A 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.
-2186 até -2199Reservado para uso futuro

11.3 Códigos de Retorno de Comunicação – Erros X-Plug

A tabela abaixo descreve os possíveis códigos de retorno de problemas de comunicação que irão possuir o código -XX:

ConstanteCódigoDescrição
MODSTS_HOSTNAMEERR-27Erro de resolução de DNS.
MODSTS_NONET-26A conexão foi bem-sucedida, mas a rede destino (ex.:
Internet) parece não estar acessível.
MODSTS_WIFI_ERR_PASSWD-25Erro de senha WiFi.
MODSTS_WIFI_ERR_AUTH-24Erro de autenticação WiFi.
MODSTS_SSLEXPIRY-23Erro de conexão SSL, certificado expirado.
MODSTS_ETHERNETFAIL-22O registro na rede Ethernet falhou.
MODSTS_DHCPFAIL-21Falha na obtenção de endereço de IP dinâmico.
MODSTS_SSLNAMEMISM-20O nome do host (hostname ou IP) não corresponde ao
common name do certificado do host.
MODSTS_WIFICONNERR-19Erro na conexão WiFi.
MODSTS_VPNFAIL-18Erro na conexão de VPN.
MODSTS_SSLNCONN-17Erro de conexão SSL.
MODSTS_SSLCERTERR-16Erro no certificado SSL.
MODSTS_WIFINOTFOUND-15Rede WiFi não encontrada.
MODSTS_SIMBLOCKED-14Erro, SIM Card bloqueado.
MODSTS_SOCKETCONN-13Falha na conexão de socket TCP/IP.
MODSTS_PPPNEGFAILED-12Falha na negociação PPP.
MODSTS_ATTACHFAILED-11Falha na ativação ou atracamento do GPRS.
MODSTS_NOTREGISTERED-10Não registrado em uma rede WiFi ou sinal muito fraco.
MODSTS_WRONGSIMPIN-9PIN de SIM Card incorreto.
MODSTS_SIMERROR-8Erro na comunicação com o SIM Card.
MODSTS_NOSIM-7SIM Card não está presente.
MODSTS_BASENFOUND-6Falha na conexão da base Wireless.
MODSTS_SYNCERROR-5Erro de sincronização do modem.
MODSTS_NOANSWER-4Nenhum tom de resposta foi encontrado.
MODTST_BUSY-3Tom de ocupado detectado.
MODSTS_NODIALTONE-2Tom de discagem não detectado.
MODSTS_NOLINE-1Linha telefônica não detectada.
MODSTS_OFF0Modem está desligado.
MODSTS_REGISTERING1Registrando na rede Wireless.