Dicionário de dados

A tabela a seguir lista os principais dados que podem ser informados pela Automação através de PW_iAddParam e/ou obtidos da biblioteca através de PW_iGetResult.

🚧

Importante 1

Esta lista não é exaustiva. Dados não listados nesta tabela podem ser solicitados pelo PayGo para captura pela Automação.

🚧

Importante 2

Esses dados devem, obrigatoriamente, estar na faixa ASCII entre o valor 20h (32 decimal) e o valor 7Eh (126 decimal) e possuir o terminador nulo. Não é possível utilizar ‘ç’ e nem caracteres acentuados.

A coluna E e S são referentes aos dados que podem ser solicitados nas funções PW_iAddParam e PW_iGetResultrespectivamente. Eles serão marcados com um “X”.
Existem campos condicionais para a coluna E (Entrada) e S (Saída):

C1 – Campo pode ser adicionado pela função PW_iAddParam e pode ser obtido pelo PW_iGetResult.
C2 – Campo pode ser obtido pela função PW_iGetResult no final da transação.
C3 – Campo é informado pela automação para apresentar uma mensagem no display ou para uma captura de dados.

Nome

E

S

Valor

Tam.

Descrição

PWINFO_OPERATION

X

02h

3

Tipo de transação (PWOPER_xxx). Consultar os valores possíveis na descrição da função PW_iNewTransac (página 18).

PWINFO_PPPPWD

X

X

03h

até 21

Usuário para autenticação PPP.

PWINFO_LOCALIP

X

X

09h

16

Endereço local no formato “VVV:VVV:VVV:VVV”, para conexão com IP fixo.

PWINFO_GATEWAY

X

X

0Ah

até 16

Endereço de gateway, no formato “VVV.VVV.VVV.VVV”.

PWINFO_
SUBNETMASK

X

0Bh

até 16

Máscara de subrede, no formato “VVV.VVV.VVV.VVV”.

PWINFO_SSID

X

X

0Ch

até 33

SSID da rede Wi-Fi cadastrada.

PWINFO_POSID

X

X

11h

até 11

Identificador do Ponto de Captura.

PWINFO_AUTNAME

X

15h

até 128

Nome do aplicativo de Automação.

PWINFO_AUTVER

X

16h

até 128

Versão do aplicativo de Automação.

PWINFO_AUTDEV

X

17h

até 50

Empresa desenvolvedora do aplicativo de Automação.

PWINFO_DESTTCPIP

X

X

1Bh

até 50

Endereço TCP/IP para comunicação com a infraestrutura PayGo, no formato <endereço IP>:<porta TCP> ou <nome do servidor>:<porta TCP>

PWINFO_
MERCHCNPJCPF

X

X

1Ch

até 14

CNPJ (ou CPF) do Estabelecimento, sem formatação.
No caso de estarem sendo utilizadas afiliações de mais de um estabelecimento, este dado pode ser adicionado pela automação para selecionar previamente o estabelecimento a ser utilizado para determinada transação. Caso este dado não seja informado, será solicitada a exibição de um menu para a escolha dentre os vários estabelecimentos disponíveis.

PWINFO_AUTCAP

X

24h

até 8

Capacidades da Automação (soma dos valores abaixo):
1: funcionalidade de troco/saque;
2: funcionalidade de desconto;
4: valor fixo, sempre incluir;
8: impressão das vias diferenciadas do comprovante para Cliente/Estabelecimento;
16: impressão do cupom reduzido;
32: utilização de saldo total do voucher para abatimento do valor da compra;
64: remoção do cartão do pinpad;
128: exibição de mensagem no checkout;
256: exibição de QR Code no checkout.

PWINFO_TOTAMNT

X

X

25h

12

Valor total da operação, considerando PWINFO_CURREXP (em centavos se igual a 2), incluindo desconto, saque, gorjeta, taxa de embarque, etc.

PWINFO_CURRENCY

X

X

26h

até 4

Moeda (padrão ISSO4217, 986 para o Real)

PWINFO_CURREXP

X

27h

até 2

Expoente da moeda (2 para centavos)

PWINFO_FISCALREF

X

28h

até 12

Identificador do documento fiscal.

PWINFO_CARDTYPE

X

X

29h

até 2

Tipo de cartão utilizado (PW_iGetResult), ou tipos de cartão aceitos (soma dos valores abaixo, PW_iAddParam):
1: crédito
2: débito
4: voucher/PAT
8: private label
16: frota
128: outros

PWINFO_
PRODUCTNAME

X

2Ah

até 20

Nome/tipo do produto utilizado, na nomenclatura do Provedor.

PWINFO_DATETIME

X

31h

14

Data e hora local da transação, no formato “AAAAMMDDhhmmss”.

PWINFO_REQNUM

X

32h

até 10

Referência local da transação.

PWINFO_AUTHSYST

X

X

35h

até 20

Nome do Provedor:
“ELAVON”;
“FILLIP”;
“LIBERCARD”;
“RV”;
etc.

PWINFO_VIRTMERCH

X

X

36h

até 9

Identificador do Estabelecimento.

PWINFO_
AUTMERCHID

X

38h

até 50

Identificador do estabelecimento para o Provedor (código de afiliação).

PWINFO_
PHONEFULLNO

X

PWINFO_
PHONEFULLNO

até 11

Número do telefone, com o DDD (10 ou 11 dígitos).

PWINFO_FINTYPE

X

X

3Bh

até 2

Modalidade de financiamento da transação:
1: à vista
2: parcelado pelo emissor
4: parcelado pelo estabelecimento
8: pré-datado
16: crédito emissor

PWINFO_
INSTALLMENTS

X

X

3Ch

até 2

Quantidade de parcelas.

PWINFO_
INSTALLMDATE

X

X

3Dh

6

Data de vencimento do pré-datado, ou da primeira parcela.
Formato “DDMMAA”.

PWINFO_
PRODUCTID

X

3Eh

até 8

Identificação do produto utilizado, de acordo com a nomenclatura do Provedor.

PWINFO_
RESULTMSG

X

42h

até 80

Mensagem descrevendo o resultado final da transação, seja esta bem ou mal sucedida (conforme “4.3.Interface com o usuário”, página 8).

PWINFO_CNFREQ

X

43h

1

Necessidade de confirmação:
0: não requer confirmação;
1: requer confirmação.

PWINFO_
AUTLOCREF

X

44h

até 50

Referência da transação para a infraestrutura PayGo.

PWINFO_AUTEXTREF

X

45h

até 50

Referência da transação para o Provedor (NSU host).

PWINFO_AUTHCODE

X

46h

6

Código de autorização.

PWINFO_
AUTRESPCODE

X

47h

até 10

Código de resposta da transação (campo ISSO8583:39)

PWINFO_
AUTDATETIME

48h

14

Data/hora da transação para o Provedor, formato “AAAAMMDDhhmmss”.

PWINFO_
DISCOUNTAMT

X

49h

até 12

Valor do desconto concedido pelo Provedor, considerando PWINFO_CURREXP, já deduzido em PWINFO_TOTAMNT.

PWINFO_
CASHBACKAMT

X

X

4Ah

12

Valor do saque/troco, considerando PWINFO_CURREXP, já incluído em PWINFO_TOTAMNT.

PWINFO_CARDNAME

X

4Bh

até 12

Nome do cartão ou do emissor do cartão.

PWINFO_ONOFF

X

X

4Ch

1

Modalidade da transação:
1: online
2: off-line

PWINFO_
BOARDINGTAX

X

X

4Dh

12

Valor da taxa de embarque, considerando PWINFO_CURREXP, já incluído em PWINFO_TOTAMNT.

PWINFO_
TIPAMOUNT

X

X

4Eh

12

Valor da taxa de serviço (gorjeta), considerando PWINFO_CURREXP, já incluído em PWINFO_TOTAMNT.

PWINFO_
INSTALLM1AMT

X

X

4Fh

12

Valor da entrada para um pagamento parcelado, considerando PWINFO_CURREXP, já incluído em PWINFO_TOTAMNT.

PWINFO_
INSTALLMAMNT

X

X

50h

12

Valor da parcela, considerando PWINFO_CURREXP, já incluído em PWINFO_TOTAMNT.

PWINFO_RCPTFULL

X

52h

Comprovante para impressão – Via completa.
Até 40 colunas, quebras de linha identificadas pelo caractere 0Dh.

PWINFO_
RCPTMERCH

X

53h

Comprovante para impressão – Via diferenciada para o Estabelecimento.
Até 40 colunas, quebras de linha identificadas pelo caractere 0Dh.

PWINFO_
RCPTCHOLDER

X

54h

Comprovante para impressão – Via diferenciada para o Cliente.
Até 40 colunas, quebras de linha identificadas pelo caractere 0Dh.

PWINFO_
RCPTCHSHORT

X

55h

Comprovante para impressão – Cupom reduzido (para o Cliente).
Até 40 colunas, quebras de linha identificadas pelo caractere 0Dh.

PWINFO_
TRNORIGDATE

X

X

57h

6

Data da transação original, no caso de um cancelamento ou uma confirmação de pré-autorização (formato “DDMMAA”).

PWINFO_
TRNORIGNSU

X

X

58h

até 50

NSU da transação original, no caso de um cancelamento ou uma confirmação de pré-autorização.

PWINFO_
SALDOVOUCHER

X

59h

Saldo do cartão voucher recebido do autorizador.

PWINFO_
TRNORIGAMNT

X

60h

12

Valor da transação original, no caso de um cancelamento ou uma confirmação de pré-autorização.

PWINFO_
TRNORIGAUTH

X

X

62h

até 6

Código de autorização da transação original, no caso de um cancelamento ou uma confirmação de pré-autorização.

PWINFO_
LANGUAGE

X

X

6Ch

1

Idioma a ser utilizado para a interface com o cliente:
0: Português
1: Inglês
2: Espanhol

PWINFO_
PROCESSMSG

X

6Fh

até 84

Mensagem a ser exibida para o cliente durante o processamento da transação.

PWINFO_
TRNORIGREQNUM

X

72h

até 10

Número da solicitação da transação original, no caso de um cancelamento ou uma confirmação de pré-autorização.

PWINFO_
TRNORIGTIME

X

X

73h

6

Hora da transação original, no caso de um cancelamento ou uma confirmação de pré-autorização (formato “HHMMSS”).

PWINFO_
CNCDSPMSG

X

74h

até 84

Mensagem a ser exibida para o operador no terminal no caso da transação ser abortada (cancelamento ou timeout).

PWINFO_
CNCPPMSG

X

75h

32

Mensagem a ser exibida para o portador no pinpad no caso de a transação ser abortada (cancelamento ou timeout).

PWINFO_
TRNORIGLOCREF

X

X

78h

até 50

Referência local da transação original, no caso de um cancelamento.

PWINFO_
AUTHSYSTEXTENDED

X

X

87h

até 20

Nome do provedor, independente do emissor e/ou subadquirencia.

PWINFO_
CARDENTMODE

X

C0h

3

Modo(s) de entrada do cartão:
1: digitado
2: tarja magnética
4: chip com contato
16: fallback de chip para tarja
32: chip sem contato simulando tarja (cliente informa tipo efetivamente utilizado)
64: chip sem contato EMV (cliente informa tipo efetivamente utilizado)
256: fallback de tarja para digitado
512: fallback de sem contato para contato.

PWINFO_
CARDFULLPAN

X

C1h

até 19

Número do cartão completo, para transação digitada. Este dado não pode ser recuperado pela função PW_iGetResult.

PWINFO_
CARDEXPDATE

X

X

C2h

4

Data de vencimento do cartão (formato “MMAA”).

PWINFO_
CARDNAMESTD

X

C4h

até 50

Descrição do produto bandeira padrão relacionado ao BIN.

PWINFO_
PRODNAMEDESC

X

C5h

até 100

Descrição do nome do produto ou bandeira.

PWINFO_
CARDPARCPAN

X

C8h

até 19

Número do cartão, truncado ou mascarado.

PWINFO_
CHOLDVERIF

X

CFh

1

Método(s) de autenticação do Cliente, soma dos seguintes valores:
“1”: Assinatura em papel.
“2”: Senha verificada off-line.
“4”: Senha off-line bloqueada no decorrer desta transação.
“8”: Senha verificada online.
“16”: Autenticação no dispositivo móvel do Cliente

PWINFO_
EMVRESPCODE

X

D6h

1

Identificador do resultado final do processamento de cartão com chip:
1: Transação aprovada.
2: Transação negada pelo cartão.
3.Transação negada pelo Host.
Caso não seja uma transação com chip, o valor não irá existir.

PWINFO_AID

X

D8h

Aplicação do cartão utilizada durante a transação.

PWINFO_
BARCODENTMODE

C1

C1

E9h

1

Modo(s) de entrada do código de barras:
1: digitado;
2: lido através de dispositivo eletrônico.

PWINFO_BARCODE

C2

Eah

até 48

Código de barras completo, lido ou digitado.

PWINFO_
MERCHADDDATA1

C2

F0h

até 127

Dados adicionais relevantes para a Automação (#1)

PWINFO_
MERCHADDDATA2

C2

F1h

até 127

Dados adicionais relevantes para a Automação (#2)

PWINFO_
MERCHADDDATA3

C2

F2h

até 127

Dados adicionais relevantes para a Automação (#3)

PWINFO_RCPTPRN

X

F4h

1

Indica quais vias de comprovante devem ser impressas:
0: não há comprovante
1: imprimir somente a via do Cliente
2: imprimir somente a via do Estabelecimento
3: imprimir ambas as vias do Cliente e do Estabelecimento

PWINFO_
AUTHMNGTUSER

X

F5h

até 50

Identificador do usuário autenticado com a senha do lojista.

PWINFO_
AUTHTECHUSER

X

F6h

até 50

Identificador do usuário autenticado com a senha técnica.

PWINFO_
MERCHNAMERCPT

X

Fah

até 40

Nome que identifica o estabelecimento nos comprovantes.

PWINFO_
PRODESTABRCPT

X

FBh

até 26

Descrição do produto/cartão utilizado na transação, para o estabelecimento.

PWINFO_
PRODCLIRCPT

X

FCh

até 26

Descrição do produto/cartão utilizado na transação, para o cliente.

PWINFO_
EMVCRYPTTYPE

X

FDh

2 ou 4

Tipo de criptograma gerado no 1º Generate AC do processo EMV:
“ARQC” para transações submetidas à autorização do emissor.
“TC” para transações efetuadas sem autorização do emissor.

PWINFO_
TRNORIGAUTHCODE

C1

C1

Feh

6

Código de autorização da transação original, no caso de um cancelamento.

PWINFO_
PAYMNTTYPE

X

X

1F21h

até 2

Modalidade de pagamento:
1: cartão
2: dinheiro
4: cheque
8: carteira virtual

PWINFO_
GRAPHICRCPHEADER
Q

X

1F36h

até 100

Cabeçalho do comprovante gráfico recebido do servidor.

PWINFO_
GRAPHICRCPFOOTER

X

1F37h

até 200

Rodapé do comprovante gráfico recebido do servidor.

PWINFO_
CHOLDERNAME

X

1F38h

até 26

Nome do portador do cartão utilizado, o tamanho segue o mesmo padrão da tag 5F20 EMV.

PWINFO_
MERCHNAMEPDC

X

1F39h

até 100

Nome do estabelecimento em que o ponto de captura está cadastrado.

PWINFO_
TRANSACDESCRIPT

X

1F40h

até 80

Descritivo da transação realizada, por exemplo, CREDITO A VISTA ou VENDA PARCELADA EM DUAS VEZES.

PWINFO_ARQC

X

1F41h

até 20

ARQC.

PWINFO_DEFAULT
CARDPARCPAN

X

1F42h

até 20

Número do cartão mascarado no formato BIN + *+ 4 últimos dígitos. Ex.: 543211****9876

PWINFO_
SOFTDESCRIPTOR

X

1F43h

até 30

Texto que será de identificação na fatura do portador do cartão

PWINFO_RCPT
ADDINFOESTABCLI

X

1F44h

até 500

Mensagem texto destinada a ambos: ao cliente e ao estabelecimento.

PWINFO_
RCPTADDINFOCLI

X

1F45h

até 500

Mensagem texto destinada ao cliente.

PWINFO_
RCPTADDINFOESTAB

X

1F46h

até 500

Mensagem texto destinada ao estabelecimento.

PWINFO_
SPLITPAYMENT

X

1F59h

até 62

O campo PWINFO_SPLITPAYMENT deverá possuir as seguintes informações separadas por vírgula ‘,’:
Afiliação: Identificador do lojista do ponto de vista do Provedor.
Valor: Valor parcial a ser enviado para a afiliação do split.
OBS: A soma de todos os valores referente ao split de pagamento deverá ser igual a PWINFO_TOTAMNT
Exemplo: 8DA10E01A6A6213, 1200
Para cada conjunto de informações de split de pagamento, conforme o exemplo acima, deverá ser feito o PW_iAddParam informando a tag PWINFO_SPLITPAYMENT e as informações atualizadas.

PWINFO_
AUTHPOSQRCODE

X

1F77h

até 5000

Conteúdo do QR Code identificando o checkout para o autorizador

PWINFO_
WALLETUSERIDTYPE

X

X

1F81h

até 3

Forma de identificação do portador da carteira virtual:
1: QRCode do checkout (lido pelo celular do portador)
2: CPF
128: outros

PWINFO_RCPTECVID

X

1F91h

até 10

Identificador do estabelecimento virtual que está processando a transação. O campo é utilizado na montagem do comprovante próprio.

PWINFO_
USINGPINPAD

X

X

7F01h

1

Indica se o ponto de captura faz ou não o uso de pinpad:
0: Não utiliza pinpad;
1: Utiliza pinpad.

PWINFO_
PPCOMMPORT

X

X

7F02h

2

Número da porta serial à qual o pinpad está conectado. O valor 0 (zero) indica uma busca automática desta porta.

PWINFO_
IDLEPROCTIME

X

7F04h

12

Próxima data e horário em que a função PW_iIdleProc deve ser chamada pela Automação.
Formato “AAMMDDHHMMSS”.

PWINFO_
PNDAUTHSYST

X

7F05h

até 20

Nome do provedor para o qual existe uma transação pendente.

PWINFO_
PNDVIRTMERCH

X

7F06h

até 9

Identificador do Estabelecimento para o qual existe uma transação pendente.

PWINFO_
PNDREQNUM

X

7F07h

até 10

Referência local da transação que está pendente.

PWINFO_
PNDAUTLOCREF

X

7F08h

até 50

Referência para a infraestrutura PayGo da transação que está pendente.

PWINFO_
PNDAUTEXTREF

X

7F09h

até 50

Referência para o Provedor da transação que está pendente.

PWINFO_LOCALINFO1

X

7F0Ah

até 40

Texto exibido para um item de menu selecionado pelo usuário.

PWINFO_SERVERPND

X

7F0Bh

1

Indica se o ponto de captura possui alguma pendência a ser resolvida com o PayGo:
0: não possui pendência;
1: possui pendência.

PWINFO_PPINFO

X

7F15h

100

Informações do pinpad conectado, seguindo o padrão posição/informação abaixo:
001-020 / Nome do fabricante do pinpad.
021-039 / Modelo/versão do hardware.
040 / Se o pinpad suporta cartão com chip sem contato, este campo deve conter a letra “C”, caso contrário um espaço em branco.
041-060 / Versão do software básico/firmware.
061-064 / Versão da especificação, no formato “V.VV”.
065-080 / Versão da aplicação básica, no formato “VVV.VV AAMMDD” (com 3 espaços à direita).
081-100 / Número de série do pinpad (com espaços à direita).

PWINFO_RESULTID

X

7F16h

até 8

Identificador do resultado da operação do ponto de vista do Servidor

PWINFO_
DSPCHECKOUT1

C3

7F17h

até 84

Mensagem a ser exibida no cliente durante as transições de determinadas capturas. A automação deverá informar a capacidade desse tratamento no PWINFO_AUTCAP

PWINFO_
DSPCHECKOUT2

C3

7F18h

até 84

Mensagem a ser exibida no cliente durante as transições de determinadas capturas. A automação deverá informar a capacidade desse tratamento no PWINFO_AUTCAP

PWINFO_
DSPCHECKOUT3

C3

7F19h

até 84

Mensagem a ser exibida no cliente durante as transições de determinadas capturas. A automação deverá informar a capacidade desse tratamento no PWINFO_AUTCAP

PWINFO_
DSPCHECKOUT4

C3

7F1Ah

até 84

Mensagem a ser exibida no cliente durante as transições de determinadas capturas. A automação deverá informar a capacidade desse tratamento no PWINFO_AUTCAP

PWINFO_
DSPCHECKOUT5

C3

7F1Bh

até 84

Mensagem a ser exibida no cliente durante as transições de determinadas capturas. A automação deverá informar a capacidade desse tratamento no PWINFO_AUTCAP

PWINFO_
CTLSCAPTURE

X

7F1Ch

1

Deve ser adicionado para sinalizar que a automação deseja fazer uma captura de cartão sem contato. Se o autorizador permitir, a captura será executada. Não deverá ser adicionada caso já tenha sido capturado cartão digitado, trilha magnética ou chip.

PWINFO_
CHOLDERGRARCP

X

7F1Dh

1

Deve ser adicionado para sinalizar que a vila do cliente foi impressa utilizando o comprovante gráfico

PWINFO_
MERCHGRARCP

X

7F1Eh

1

Deve ser adicionado para sinalizar que a via do estabelecimento foi impressa utilizando o comprovante gráfico.

PWINFO_
AUTADDRESS

X

7F1F

até 57

Endereço TCP/IP para comunicação com automação comercial quando terminal POS operando integrado à automação no formato <endereço IP >:<porta TCP> ou <nome do servidor>:<porta TCP>

PWINFO_APN

X

7F20h

até 51

APN caso terminal esteja configurado para operar utilizando GPRS.

PWINFO_LIBVERSION

X

7F21h

16

Versão da biblioteca no formato “VVV.VVV.VVV.VVV”.

PWINFO_TSTKEYTYPE

C3

7F30h

até 3

Tipo de teste de chaves que será executado pela biblioteca, essa informação só será considerada caso a opção for PWOPER_TSTKEY:
1: PIN – DUKPT 3DES
2: PIN – MK 3DES
4: PIN – MK DES
8: DADOS – DUKPT 3DES
16: DADOS – MK 3DES
32: DADOS – MK DES
Atenção: Caso a criptografia não seja suportada pelo pinpad, esta não será executada. Para a realização do teste completo, os valores devem ser enviados somados.

PWINFO_
TKPINDUKPT3DES

X

7F32h

25

Sequência de valores que indicam a situação das chaves de PIN DUKPT 3DES. O significado dos valores são:
1 – Chave ausente.
2 – Chave presente.
3 – Chave válida.
4 – Chave inválida.
5 – Chave não validada (Durante o teste o usuário pressionou “anula” no equipamento).
Exemplo de dado retornado:
“12221212111111122211111111111111111”, ou seja, a chave da posição 1 está ausente, a chave da posição 2 está presente, assim sucessivamente.

PWINFO_
TKPINMK3DES

X

7F33h

25

Sequência de valores que indicam a situação das chaves de PIN MK 3DES. O significado dos valores são:
1 – Chave ausente.
2 – Chave presente.
3 – Chave válida.
4 – Chave inválida.
5 – Chave não validada (Durante o teste o usuário pressionou “anula” no equipamento).
Exemplo de dado retornado:
“13331413111111133311111111111111111”, ou seja, a chave da posição 1 está ausente, a chave da posição 2 está válida, assim sucessivamente.

PWINFO_
TKPINMKDES

X

7F34h

25

Sequência de valores que indicam a situação das chaves de PIN MK DES. O significado dos valores são:
1 – Chave ausente.
2 – Chave presente.
3 – Chave válida.
4 – Chave inválida.
5 – Chave não validada (Durante o teste o usuário pressionou “anula” no equipamento).
Exemplo de dado retornado:
“13331413111111133311111111111111111”, ou seja, a chave da posição 1 está ausente, a chave da posição 2 está válida, assim sucessivamente.

PWINFO_
TKDADOSDUKPT3DES

X

7F35h

25

Sequência de valores que indicam a situação das chaves de DADOS DUKPT 3DES. O significado dos valores são:
1 – Chave ausente.
2 – Chave presente.
3 – Chave válida.
4 – Chave inválida.
5 – Chave não validada (Durante o teste o usuário pressionou “anula” no equipamento).
Exemplo de dado retornado:
“12221212111111122211111111111111111”, ou seja, a chave da posição 1 está ausente, a chave da posição 2 está presente, assim sucessivamente.

PWINFO_
TKDADOSMK3DES

X

7F36h

25

Sequência de valores que indicam a situação das chaves de DADOS MK 3DES. O significado dos valores são:
1 – Chave ausente.
2 – Chave presente.
3 – Chave válida.
4 – Chave inválida.
5 – Chave não validada (Durante o teste o usuário pressionou “anula” no equipamento).
Exemplo de dado retornado:
“13331413111111133311111111111111111”, ou seja, a chave da posição 1 está ausente, a chave da posição 2 está válida, assim sucessivamente.

PWINFO_
TKDADOSMKDES

X

7F37h

25

Sequência de valores que indicam a situação das chaves de DADOS MK DES. O significado dos valores são:
1 – Chave ausente.
2 – Chave presente.
3 – Chave válida.
4 – Chave inválida.
5 – Chave não validada (Durante o teste o usuário pressionou “anula” no equipamento).
Exemplo de dado retornado:
“13331413111111133311111111111111111”, ou seja, a chave da posição 1 está ausente, a chave da posição 2 está válida, assim sucessivamente.

PWINFO_
DSPTESTKEY

C3

7F38h

até 84

Mensagem a ser exibida no cliente durante as transições de determinadas capturas. A automação deverá informar a capacidade desse tratamento no PWINFO_AUTCAP.

PWINFO_
GETKSNPIN

X

X

7F39h

até 31

Retorna o KSN de uma dada chave DUKPT3DES de PIN cujo resultado do teste tenha sido 1 (chave presente).
Para indicar qual item deve ser consultado, primeiro deve-se adicionar o índice, por exemplo, “01”, chamando a função PW_iAddParam. Em seguida, consultar o resultado por meio de PW_iGetResult. Nesse resultado, é retornado o KSN já em caracteres imprimíveis.

PWINFO_
GETKSNDATA

X

X

7F40h

até 31

Retorna o KSN de uma dada chave DUKPT3DES de PIN cujo resultado do teste tenha sido 1 (chave presente).
Para indicar qual item deve ser consultado, primeiro deve-se adicionar o índice, por exemplo, “01”, chamando a função PW_iAddParam. Em seguida, consultar o resultado por meio de PW_iGetResult. Nesse resultado, é retornado o KSN já em caracteres imprimíveis.

PWINFO_
PINDUKPT3DESNAME

X

X

7F41h

até 11

Retorna o nome relacionado a um item do teste de chaves para uma chave DUKPT3DES de PIN. Para Para indicar qual item deve ser consultado, primeiro deve-se adicionar o índice, por exemplo, “01”, chamando a função PW_iAddParam. Em seguida, consultar o resultado por meio de PW_iGetResult. Nesse resultado, é retornado o nome.

PWINFO_
PINMK3DESNAME

X

X

7F42h

até 11

Retorna o nome relacionado a um item do teste de chaves para uma chave MK3DES de PIN. Para Para indicar qual item deve ser consultado, primeiro deve-se adicionar o índice, por exemplo, “01”, chamando a função PW_iAddParam. Em seguida, consultar o resultado por meio de PW_iGetResult. Nesse resultado, é retornado o nome.

PWINFO_
PINMKDESNAME

X

X

7F43h

até 11

Retorna o nome relacionado a um item do teste de chaves para uma chave MKDES de PIN. Para Para indicar qual item deve ser consultado, primeiro deve-se adicionar o índice, por exemplo, “01”, chamando a função PW_iAddParam. Em seguida, consultar o resultado por meio de PW_iGetResult. Nesse resultado, é retornado o nome.

PWINFO_DATA
DUKPT3DESNAME

X

X

7F44h

até 11

Retorna o nome relacionado a um item do teste de chaves para uma chave DUKPT3DES de dados. Para Para indicar qual item deve ser consultado, primeiro deve-se adicionar o índice, por exemplo, “01”, chamando a função PW_iAddParam. Em seguida, consultar o resultado por meio de PW_iGetResult. Nesse resultado, é retornado o nome.

PWINFO_
DATAMK3DESNAME

X

X

7F45h

até 11

Retorna o nome relacionado a um item do teste de chaves para uma chave MK3DES de dados. Para Para indicar qual item deve ser consultado, primeiro deve-se adicionar o índice, por exemplo, “01”, chamando a função PW_iAddParam. Em seguida, consultar o resultado por meio de PW_iGetResult. Nesse resultado, é retornado o nome.

PWINFO_
DATAMKDESNAME

X

X

7F46h

até 11

Retorna o nome relacionado a um item do teste de chaves para uma chave MKDES. Para Para indicar qual item deve ser consultado, primeiro deve-se adicionar o índice, por exemplo, “01”, chamando a função PW_iAddParam. Em seguida, consultar o resultado por meio de PW_iGetResult. Nesse resultado, é retornado o nome.

PWINFO_SERNUM

X

7F47h

até 21

Retorna o número serial do terminal, para plataformas em que isso faça sentido.

PWINFO_MACADDR

X

7F48h

12

Endereço MAC do terminal, no formato “XX:XX:XX:XX”

PWINFO_IPADDRESS

X

7F4Ah

16

Endereço IP do terminal.

PWINFO_SSID_IDX

X

X

7F4Bh

33

Retorna o SSID relacionado a um índice caso plataforma seja compilada com a funcionalidade de múltiplos SSID’s. Para consulta primeiro deve-se adicionar o índice, por exemplo, “01”, chamando a função PW_iAddParam. Em seguida, consultar o resultado por meio de PW_iGetResult. Nesse resultado, é retornado o nome.

PWINFO_
DNSSERVER_P

X

7F4Ch

16

Servidor de DNS primário configurado.

PWINFO_
DNSSERVER_S

X

7F4Dh

16

Servidor de DNS secundário configurado.

PWINFO_OSVERSION

X

7F4Eh

até 128

Versão do sistema operacional.

PWINFO_
APPDOWNLOADVER

X

7F4Fh

até 10

Versão da biblioteca de telecarga.

PWINFO_DSPQRPREF

X

7F50h

até 8

Caso a exibição de QR Code seja suportada pela Automação Comercial e pelo PIN-Pad, indica a preferência do local de exibição:
1: exibe no PIN-Pad;
2: exibe no checkout;
OBS: Caso esse campo não seja informado pela automação e o ponto de captura esteja configurado como autoatendimento, o QR Code é exibido no checkout. Caso contrário, é exibido no pinpad.

PWINFO_DUEAMNT

X

BF06h

até 12

Valor devido pelo usuário, considerando PWINFO_CURREXP, já deduzido em PWINFO_TOTAMNT.

PWINFO_
READJUSTEDAMNT

X

BF09h

até 12

Valor total da transação reajustado, este campo será utilizado caso o autorizador, por alguma regra de negócio específica dele, resolva alterar o valor total que foi solicitado para a transação.

PWINFO_
TRNORIGDATETIME

X

BF0Dh

14

Data e hora da transação original, no formato “AAAAMMDDhhmmss”, no caso de um cancelamento.

PWINFO_
DATETIMERCPT

X

BF0Eh

14

Data/hora da transação para exibição no comprovante, no formato “AAAAMMDDhhmmss”.

PWINFO_UNIQUEID

X

X

BF90h

até 20

ID único da transação armazenada no banco de dados

PWINFO_TRNRESULT

X

BF91h

até 10

Resultado da transação

PWINFO_RMCCAUSE

X

BF92h

até 10

Motivo da remoção do cartão