HomeGitHubDev PayGo
Documentação

9. Dicionário de dados

Suggest Edits

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: Esta lista não é exaustiva. Dados não listados nesta tabela podem ser solicitados pelo
Pay&Go Web para captura pela Automação.

NomeValorTamanhoDescrição
PWINFO_OPERATION02h2Tipo de transação (PWOPER_xxx). Consultar os valores
possíveis na descrição da função PW_iNewTransac
PWINFO_POSID11haté 11Identificador do Ponto de Captura.
PWINFO_AUTNAME15haté 128Nome do aplicativo de Automação.
PWINFO_AUTVER16haté 128Versão do aplicativo de Automação.
PWINFO_DESTTCPIP1Bhaté 50Endereço TCP/IP para comunicação com a infraestrutura
Pay&Go Web, no formato <endereço IP>: ou
:
PWINFO_MERCHCNPJCPF1Chaté 14CNPJ (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_AUTCAP24haté 8Capacidades 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.
PWINFO_TOTAMNT25h12Valor total da operação, considerando PWINFO_CURREXP
(em centavos se igual a 2), incluindo desconto, saque,
gorjeta, taxa de embarque, etc.
PWINFO_CURRENCY26haté 4Moeda (padrão ISO4217, 986 para o Real)
PWINFO_CURREXP27haté 2Expoente da moeda (2 para centavos)
PWINFO_FISCALREF28haté 12Identificador do documento fiscal.
PWINFO_CARDTYPE29haté 2Tipo 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: outros
PWINFO_PRODUCTNAME2Ahaté 20Nome/tipo do produto utilizado, na nomenclatura do
Provedor.
PWINFO_DATETIME31h14Data e hora local da transação, no formato
“AAAAMMDDhhmmss”.
PWINFO_REQNUM32haté 10Referência local da transação.
PWINFO_AUTHSYST35haté 20Nome do Provedor:
“ELAVON”;
“FILLIP”;
“LIBERCARD”;
“RV”;
etc
PWINFO_VIRTMERCH36haté 9Identificador do Estabelecimento.
PWINFO_AUTMERCHID38haté 50Identificador do estabelecimento para o Provedor (código de
afiliação).
PWINFO_PHONEFULLNO3Ahaté 11Número do telefone, com o DDD (10 ou 11 dígitos).
PWINFO_FINTYPE3Bhaté 2Modalidade de financiamento da transação:
1: à vista
2: parcelado pelo emissor
4: parcelado pelo estabelecimento
8: pré-datado
PWINFO_INSTALLMENTS3Chaté 2Quantidade de parcelas.
PWINFO_INSTALLMDATE3Dh6Data de vencimento do pré-datado, ou da primeira parcela.
Formato “DDMMAA”.
PWINFO_PRODUCTID3Ehaté 8Identificação do produto utilizado, de acordo com a nomenclatura do Provedor.
PWINFO_RESULTMSG42haté 80Mensagem descrevendo o resultado final da transação, seja
esta bem ou mal sucedida (conforme “4.3.Interface com o
usuário”).
PWINFO_CNFREQ43h1Necessidade de confirmação:
0: não requer confirmação;
1: requer confirmação.
PWINFO_AUTLOCREF44haté 50Referência da transação para a infraestrutura Pay&Go Web.
PWINFO_AUTEXTREF45haté 50Referência da transação para o Provedor (NSU host).
PWINFO_AUTHCODE46h6Código de autorização.
PWINFO_AUTRESPCODE47haté 10Código de resposta da transação (campo ISO8583:39)
PWINFO_AUTDATETIME48h14Data/hora da transação para o Provedor, formato
“AAAAMMDDhhmmss”.
PWINFO_DISCOUNTAMT49haté 12Valor do desconto concedido pelo Provedor, considerando
PWINFO_CURREXP, já deduzido em PWINFO_TOTAMNT.
PWINFO_CASHBACKAMT4Ah12Valor do saque/troco, considerando PWINFO_CURREXP, já
incluído em PWINFO_TOTAMNT.
PWINFO_CARDNAME4Bhaté 12Nome do cartão ou do emissor do cartão.
PWINFO_ONOFF4Ch1Modalidade da transação:
1: online
2: off-line
PWINFO_BOARDINGTAX4Dh12Valor da taxa de embarque, considerando
PWINFO_CURREXP, já incluído em PWINFO_TOTAMNT.
PWINFO_TIPAMOUNT4Eh12Valor da taxa de serviço (gorjeta), considerando
PWINFO_CURREXP, já incluído em PWINFO_TOTAMNT.
PWINFO_INSTALLM1AMT4Fh12Valor da entrada para um pagamento parcelado,
considerando PWINFO_CURREXP, já incluído em
PWINFO_TOTAMNT.
PWINFO_INSTALLMAMNT50h12Valor da parcela, considerando PWINFO_CURREXP, já
incluído em PWINFO_TOTAMNT.
PWINFO_RCPTFULL52hComprovante para impressão – Via completa.
Até 40 colunas, quebras de linha identificadas pelo caractere 0Dh.
PWINFO_RCPTMERCH53hComprovante para impressão – Via diferenciada para o
Estabelecimento.
Até 40 colunas, quebras de linha identificadas pelo caractere 0Dh
PWINFO_RCPTCHOLDER54hComprovante para impressão – Via diferenciada para o
Cliente.
Até 40 colunas, quebras de linha identificadas pelo caractere 0Dh.
PWINFO_RCPTCHSHORT55hComprovante para impressão – Cupom reduzido (para o
Cliente).
Até 40 colunas, quebras de linha identificadas pelo caractere 0Dh.
PWINFO_TRNORIGDATE57h6Data da transação original, no caso de um cancelamento ou
uma confirmação de pré-autorização (formato “DDMMAA”).
PWINFO_TRNORIGNSU58haté 50NSU da transação original, no caso de um cancelamento ou uma confirmação de pré autorização.
PWINFO_TRNORIGAMNT60h12Valor da transação original, no caso de um cancelamento ou
uma confirmação de pré-autorização.
PWINFO_TRNORIGAUTH62haté 6Código de autorização da transação original, no caso de um cancelamento ou uma confirmação de pré-autorização.
PWINFO_LANGUAGE6Ch1Idioma a ser utilizado para a interface com o cliente:
0: Português
1: Inglês
2: Espanhol
PWINFO_PROCESSMSG6FhAté 84Mensagem a ser exibida para o cliente durante o
processamento da transação.
PWINFO_TRNORIGREQNUM72haté 10Número da solicitação da transação original, no caso de um cancelamento ou uma confirmação de pré-autorização
PWINFO_TRNORIGTIME73h6Hora da transação original, no caso de um cancelamento ou
uma confirmação de pré autorização (formato “HHMMSS”).
PWINFO_CNCDSPMSG74haté 84Mensagem a ser exibida para o operador no terminal no caso
da transação ser abortada (cancelamento ou timeout).
PWINFO_CNCPPMSG75h32Mensagem a ser exibida para o portador no PIN-pad no caso da transação ser abortada (cancelamento ou timeout).
PWINFO_CARDENTMODEC0h3Modo(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
PWINFO_CARDFULLPANC1haté 19Número do cartão completo, para transação digitada. Este
dado não pode ser recuperado pela função PW_iGetResult.
PWINFO_CARDEXPDATEC2h4Data de vencimento do cartão (formato “MMAA”).
PWINFO_CARDNAMESTDC4hAté 50Descrição do produto bandeira padrão relacionado ao BIN.
PWINFO_CARDPARCPANC8haté 19Número do cartão, truncado ou mascarado.
PWINFO_CHOLDVERIFCFh1Verificação do portador, soma dos seguintes valores:
“1”: Assinatura do portador em papel.
“2”: Senha verificada off-line.
“4”: Senha off-line bloqueada no decorrer desta transação.
“8”: Senha verificada online.
PWINFO_BARCODENTMODEE9h1Modo(s) de entrada do código de barras:
1: digitado;
2: lido através de dispositivo eletrônico
PWINFO_BARCODEEAhaté 48Código de barras completo, lido ou digitado.
PWINFO_MERCHADDDATA1F0haté 127Dados adicionais relevantes para a Automação (#1)
PWINFO_MERCHADDDATA2F1haté 127Dados adicionais relevantes para a Automação (#2)
PWINFO_MERCHADDDATA3F2haté 127Dados adicionais relevantes para a Automação (#3)
PWINFO_MERCHADDDATA4F3haté 127Dados adicionais relevantes para a Automação (#4)
PWINFO_RCPTPRNF4h1Indica 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_AUTHMNGTUSERF5haté 50Identificador do usuário autenticado com a senha do lojista.
PWINFO_AUTHTECHUSERF6haté 50Identificador do usuário autenticado com a senha técnica.
PWINFO_PAYMNTTYPE1F21haté 2Modalidade de pagamento:
1: cartão
2: dinheiro
3: cheque
PWINFO_USINGPINPAD7F01h1Indica se o ponto de captura faz ou não o uso de PIN-pad:
0: Não utiliza PIN-pad;
1: Utiliza PIN-pad.
PWINFO_PPCOMMPORT7F02h2Número da porta serial à qual o PIN-pad está conectado. O valor 0 (zero) indica uma busca automática desta porta.
PWINFO_IDLEPROCTIME7F04h12Próxima data e horário em que a função PW_iIdleProc deve
ser chamada pela Automação.
Formato “AAMMDDHHMMSS”.
PWINFO_PNDAUTHSYST7F05haté 20Nome do provedor para o qual existe uma transação pendente.
PWINFO_PNDVIRTMERCH7F06haté 9Identificador do Estabelecimento para o qual existe uma transação pendente.
PWINFO_PNDREQNUM7F07haté 10Referência local da transação que está pendente.
PWINFO_PNDAUTLOCREF7F08haté 50Referência para a infraestrutura Pay&Go Web da transação
que está pendente.
PWINFO_PNDAUTEXTREF7F09haté 50Referência para o Provedor da transação que está pendente.
PWINFO_LOCALINFO17F0Ahaté 40Texto exibido para um item de menu selecionado pelo
usuário.
PWINFO_SERVERPND7F0Bh1Indica se o ponto de captura possui alguma pendência a ser
resolvida com o Pay&Go Web:
0: não possui pendência;
1: possui pendência.
PWINFO_PPINFO7F15h100Informações do PIN-pad conectado, seguindo o padrão posição/informação abaixo:
001-020 / Nome do fabricante do PIN-pad.
021-039 / Modelo/versão do hardware.
040 / Se o PIN-pad 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 PIN-pad (com espaços à
direita).
PWINFO_DUEAMNTBF06hAté 12Valor devido pelo usuário, considerando PWINFO_CURREXP,
já deduzido em PWINFO_TOTAMNT.
PWINFO_READJUSTEDAMNTBF09hAté 12Valor 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

Updated over 3 years ago

A seguir...