Códigos de retorno

Códigos de Retorno da PGWebLib

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

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

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

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:

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