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.