Histórico
Consulta de Cliente Convênio (6B)
Para consultar um cliente de um convênio, deve-se utilizar o método: ConsultaClienteConvenio6B
Parâmetros de entrada
Nome | Tipo | Tamanho | Descrição |
numeroCartao | String | 19 | Número do cartão do conveniado |
codigoEstabelecimento | String | 15 | Representa o código do estabelecimento.
ESTABELECIMENTO.CODIGO_ESTABELECIMENTO |
codigoEmpresa | String | 5 | Representa o código da empresa. Ex: 00001 |
codigoLoja | String | 4 | Representa o número da loja. Deve-se completar com zeros a esquerda. Ex: Loja 1 deve ser passado 0001 |
pdv | String | 3 | Representa o número do PDV Deve-se completar com zeros a esquerda. Ex: PDV 22 deve ser passado 022 |
tipoIdentificacao | Integer | 1 | Utilizado para identificar o conteúdo do campo numeroCartao Valores possíveis:
|
Parâmetros de Saída
Nome | Tipo | Tamanho | Descrição | ||||
CodigoResposta | String | 2 | Código de Resposta da Transação. Vide item “Códigos de Resposta” no documento | ||||
NSU Safe | String | 9 | NSU do SAFE | ||||
Mensagem PDV | String | 12 | Mensagem a ser exibida no PDV | ||||
Saldo Disponível |
|
| Saldo disponível do cartão | ||||
Tempo de Resposta | Numeric | 6 | Tempo de resposta da transação | ||||
Cartao | Numeric | 19 | Numero do Cartao | ||||
DataCarga | Char | 8 | Data da primeira Carga. Máscara: AAAAMMDD | ||||
Validade | Char | 4 | Data de validade. Máscara: AAMM | ||||
DataUltimaRecarga | Char | 8 | Data da última Carga. Máscara: AAAAMMDD | ||||
TipoResgatePermitido | Char | 1 | Tipo de resgate. P – Parcial T – Total | ||||
CartaoPermiteRecarga | Char | 1 | Permite Resgate. S – Sim N – Não | ||||
ValorMinimoRecarga | Char | 12 | Valor mínimo para resgate. | ||||
ValorMaximoRecarga | Char | 12 | Valor máximo para Resgate | ||||
NomeResponsavel | Char | 25 | Nome do Cartao | ||||
Cpf | Numeric | 14 | CPF/CNPJ responsável | ||||
Matricula | Char | 10 | Matricula | ||||
TipoConvenio | Char | 1 | Tipo de Convenio 1 – Pos 2 – Pre | ||||
NomeEmpresaConveniada | Char | 40 | Nome do Convenio | ||||
FlagValidacaoCartao | Char | 1 | Tipo de Validação do Cartao. 0 - não pede nada 1 - deve pedir 4 Últ. dígitos 2 - deve pedir CVV2 3 - deve pedir 4 Últ. dígitos e CVV2 4 - deve pedir senha 5 - deve pedir senha e 4 dígitos Últ. 6 - deve pedir senha e CVV2 7 - deve pedir senha, 4 Últ. e CVV2 | ||||
QuantidadePlanos | Numeric | 2 | Quantidade de planos disponíveis | ||||
CodigoPlanoPagamento | Numeric | 5 | Código do Plano | ||||
NumeroParcelas | Numeric | 2 | Numero de Parcelas | ||||
TaxaJuros | Char | 8 | Taxa de Juros | ||||
FatorEntrada | Char | 8 | Fator de Entrada | ||||
QuantidadeValoresFixos | Char | 2 | Quantidade de valores fixos | ||||
ValoresFixos | Char | 40 | Valores Fixos | ||||
Logradouro | Char | 40 | Nome do Logradouro | ||||
Numero | Numeric | 10 | Numero | ||||
Complemento | Char | 40 | Complemento | ||||
Bairro | Char | 40 | Bairro | ||||
Cidade | Char | 40 | Cidade | ||||
Pais | Char | 3 | Sigla Pais | ||||
Uf | Char | 2 | Sigla UF | ||||
Cep | Numeric | 8 | CEP | ||||
PercentualDescontoEvento | Numeric | 10 | Percentual de Desconto | ||||
QuantidadeConvenios | Numeric | 2 | Quantidade de Convenios | ||||
Convenios | Char | 40 | Lista Convenios | ||||
ValorTotalTransacao | Char | 12 | Valor Trs | ||||
| CodigoResposta | String | 2 | Código de Resposta da Transação. Vide item “Códigos de Resposta” no documento | ||||
| NSU Safe | String | 9 | NSU do SAFE | ||||
| Mensagem PDV | String | 12 | Mensagem a ser exibida no PDV | ||||
| Saldo Disponível | Saldo disponível do cartão | ||||||
| Tempo de Resposta | Numeric | 6 | Tempo de resposta da transação |
XML de Retorno
<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://grupolinx.com.br/">
<CodigoResposta>00</CodigoResposta>
<NSUSafe>000078485</NSUSafe>
<MensagemPDV>TRANSAC APROVADA</MensagemPDV>
<SaldoDisponivel>100</SaldoDisponivel>
<TempoResposta>73311</TempoResposta>
<DataCarga>20160705</DataCarga>
<Validade>1707</Validade>
<DataUltimaRecarga>00000000000000</DataUltimaRecarga>
<TipoResgatePermitido>P</TipoResgatePermitido>
<CartaoPermiteRecarga>S</CartaoPermiteRecarga>
<ValorMinimoRecarga>000000000001</ValorMinimoRecarga>
<ValorMaximoRecarga>000001000000</ValorMaximoRecarga>
<NomeResponsavel>CLIENTE CONV PRE-PG</NomeResponsavel>
<Cpf>00000008289</Cpf>
<Matricula>4412000000</Matricula>
<TipoConvenio>2</TipoConvenio>
<NomeEmpresaConveniada>RESERVA TECNICA 6 MICHELLY</NomeEmpresaConveniada>
<FlagValidacaoCartao>0</FlagValidacaoCartao>
<QuantidadePlanos>01</QuantidadePlanos>
<CodigoPlanoPagamento>00002</CodigoPlanoPagamento>
<NumeroParcelas>01</NumeroParcelas>
<TaxaJuros>00000000</TaxaJuros>
<FatorEntrada>00000000</FatorEntrada>
<QuantidadeValoresFixos>05</QuantidadeValoresFixos>
<ValoresFixos>0001000000020000000300000004000000050000</ValoresFixos>
<Logradouro>N0000</Logradouro>
<Numero></Numero>
<Complemento></Complemento>
<Bairro></Bairro>
<Cidade></Cidade>
<Pais></Pais>
<Uf></Uf>
<Cep></Cep>
<PercentualDescontoEvento></PercentualDescontoEvento>
<QuantidadeConvenios></QuantidadeConvenios>
<Convenios></Convenios>
<ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>
Consulta de Cliente Convênio V2 (6B)
Para consultar um cliente de um convênio, utilizando o cartão secundário e seu respectivo PIN, deve-se utilizar o método: ConsultaClienteConvenio6BV2
Parâmetros de entrada
Nome | Tipo | Tamanho | Descrição |
numeroCartao | String | 19 | Número do cartão do conveniado |
codigoEstabelecimento | String | 15 | Representa o código do estabelecimento.
ESTABELECIMENTO.CODIGO_ESTABELECIMENTO |
codigoEmpresa | String | 5 | Representa o código da empresa. Ex: 00001 |
codigoLoja | String | 4 | Representa o número da loja. Deve-se completar com zeros a esquerda. Ex: Loja 1 deve ser passado 0001 |
pdv | String | 3 | Representa o número do PDV Deve-se completar com zeros a esquerda. Ex: PDV 22 deve ser passado 022 |
tipoIdentificacao | Integer | 1 | Utilizado para identificar o conteúdo do campo numeroCartao Valores possíveis:
|
numeroCartaoSecundario | String | 19 | Número do cartão secundário |
pinCartao | String | 10 | PIN do cartão secundário |
Parâmetros de Saída
Nome | Tipo | Tamanho | Descrição | ||||
CodigoResposta | String | 2 | Código de Resposta da Transação. Vide item “Códigos de Resposta” no documento | ||||
NSU Safe | String | 9 | NSU do SAFE | ||||
Mensagem PDV | String | 12 | Mensagem a ser exibida no PDV | ||||
Saldo Disponível |
|
| Saldo disponível do cartão | ||||
Tempo de Resposta | Numeric | 6 | Tempo de resposta da transação | ||||
Cartao | Numeric | 19 | Numero do Cartao | ||||
DataCarga | Char | 8 | Data da primeira Carga. Máscara: AAAAMMDD | ||||
Validade | Char | 4 | Data de validade. Máscara: AAMM | ||||
DataUltimaRecarga | Char | 8 | Data da última Carga. Máscara: AAAAMMDD | ||||
TipoResgatePermitido | Char | 1 | Tipo de resgate. P – Parcial T – Total | ||||
CartaoPermiteRecarga | Char | 1 | Permite Resgate. S – Sim N – Não | ||||
ValorMinimoRecarga | Char | 12 | Valor mínimo para resgate. | ||||
ValorMaximoRecarga | Char | 12 | Valor máximo para Resgate | ||||
NomeResponsavel | Char | 25 | Nome do Cartao | ||||
Cpf | Numeric | 14 | CPF/CNPJ responsável | ||||
Matricula | Char | 10 | Matricula | ||||
TipoConvenio | Char | 1 | Tipo de Convenio 1 – Pos 2 – Pre | ||||
NomeEmpresaConveniada | Char | 40 | Nome do Convenio | ||||
FlagValidacaoCartao | Char | 1 | Tipo de Validação do Cartao. 0 - não pede nada 1 - deve pedir 4 Últ. dígitos 2 - deve pedir CVV2 3 - deve pedir 4 Últ. dígitos e CVV2 4 - deve pedir senha 5 - deve pedir senha e 4 dígitos Últ. 6 - deve pedir senha e CVV2 7 - deve pedir senha, 4 Últ. e CVV2 | ||||
QuantidadePlanos | Numeric | 2 | Quantidade de planos disponíveis | ||||
CodigoPlanoPagamento | Numeric | 5 | Código do Plano | ||||
NumeroParcelas | Numeric | 2 | Numero de Parcelas | ||||
TaxaJuros | Char | 8 | Taxa de Juros | ||||
FatorEntrada | Char | 8 | Fator de Entrada | ||||
QuantidadeValoresFixos | Char | 2 | Quantidade de valores fixos | ||||
ValoresFixos | Char | 40 | Valores Fixos | ||||
Logradouro | Char | 40 | Nome do Logradouro | ||||
Numero | Numeric | 10 | Numero | ||||
Complemento | Char | 40 | Complemento | ||||
Bairro | Char | 40 | Bairro | ||||
Cidade | Char | 40 | Cidade | ||||
Pais | Char | 3 | Sigla Pais | ||||
Uf | Char | 2 | Sigla UF | ||||
Cep | Numeric | 8 | CEP | ||||
PercentualDescontoEvento | Numeric | 10 | Percentual de Desconto | ||||
QuantidadeConvenios | Numeric | 2 | Quantidade de Convenios | ||||
Convenios | Char | 40 | Lista Convenios | ||||
ValorTotalTransacao | Char | 12 | Valor Trs | ||||
| CodigoResposta | String | 2 | Código de Resposta da Transação. Vide item “Códigos de Resposta” no documento | ||||
| NSU Safe | String | 9 | NSU do SAFE | ||||
| Mensagem PDV | String | 12 | Mensagem a ser exibida no PDV | ||||
| Saldo Disponível | Saldo disponível do cartão | ||||||
| Tempo de Resposta | Numeric | 6 | Tempo de resposta da transação |
XML de Retorno
<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://grupolinx.com.br/">
<CodigoResposta>00</CodigoResposta>
<NSUSafe>000078485</NSUSafe>
<MensagemPDV>TRANSAC APROVADA</MensagemPDV>
<SaldoDisponivel>100</SaldoDisponivel>
<TempoResposta>73311</TempoResposta>
<DataCarga>20160705</DataCarga>
<Validade>1707</Validade>
<DataUltimaRecarga>00000000000000</DataUltimaRecarga>
<TipoResgatePermitido>P</TipoResgatePermitido>
<CartaoPermiteRecarga>S</CartaoPermiteRecarga>
<ValorMinimoRecarga>000000000001</ValorMinimoRecarga>
<ValorMaximoRecarga>000001000000</ValorMaximoRecarga>
<NomeResponsavel>CLIENTE CONV PRE-PG</NomeResponsavel>
<Cpf>00000008289</Cpf>
<Matricula>4412000000</Matricula>
<TipoConvenio>2</TipoConvenio>
<NomeEmpresaConveniada>RESERVA TECNICA 6 MICHELLY</NomeEmpresaConveniada>
<FlagValidacaoCartao>0</FlagValidacaoCartao>
<QuantidadePlanos>01</QuantidadePlanos>
<CodigoPlanoPagamento>00002</CodigoPlanoPagamento>
<NumeroParcelas>01</NumeroParcelas>
<TaxaJuros>00000000</TaxaJuros>
<FatorEntrada>00000000</FatorEntrada>
<QuantidadeValoresFixos>05</QuantidadeValoresFixos>
<ValoresFixos>0001000000020000000300000004000000050000</ValoresFixos>
<Logradouro>N0000</Logradouro>
<Numero></Numero>
<Complemento></Complemento>
<Bairro></Bairro>
<Cidade></Cidade>
<Pais></Pais>
<Uf></Uf>
<Cep></Cep>
<PercentualDescontoEvento></PercentualDescontoEvento>
<QuantidadeConvenios></QuantidadeConvenios>
<Convenios></Convenios>
<ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>
Consulta Lista de Cartões por CPF/CNPJ (6B)
Para consultar uma lista de cartões por CPF/CNPJ, deve-se utilizar o método: ConsultaClienteConvenio6BExt
Obs: Esse método irá retornar um array de objetos RespostaSAFE.
Parâmetros de entrada
Nome | Tipo | Tamanho | Descrição |
numeroCartao | String | 19 | Número do cartão do conveniado |
codigoEstabelecimento | String | 15 | Representa o código do estabelecimento.
ESTABELECIMENTO.CODIGO_ESTABELECIMENTO |
codigoEmpresa | String | 5 | Representa o código da empresa. Ex: 00001 |
codigoLoja | String | 4 | Representa o número da loja. Deve-se completar com zeros a esquerda. Ex: Loja 1 deve ser passado 0001 |
pdv | String | 3 | Representa o número do PDV Deve-se completar com zeros a esquerda. Ex: PDV 22 deve ser passado 022 |
tipoIdentificacao | Integer | 1 | Utilizado para identificar o conteúdo do campo numeroCartao Valores possíveis:
|
Para utilizar tipoIdentificacao 5 ou 6, o valor do documento deve ser enviado no parâmetro numeroCartao.
Parâmetros de Saída
Nome | Tipo | Tamanho | Descrição |
CodigoResposta | String | 2 | Código de Resposta da Transação. Vide item “Códigos de Resposta” no documento |
NSU Safe | String | 9 | NSU do SAFE
|
Mensagem PDV | String | 12 | Mensagem a ser exibida no PDV
|
Saldo Disponível |
|
| Saldo disponível do cartão |
Tempo de Resposta | Numeric | 6 | Tempo de resposta da transação |
Cartao | Numeric | 19 | Numero do Cartao |
DataCarga | Char | 8 | Data da primeira Carga. Máscara: AAAAMMDD |
Validade | Char | 4 | Data de validade. Máscara: AAMM |
DataUltimaRecarga | Char | 8 | Data da última Carga. Máscara: AAAAMMDD |
TipoResgatePermitido | Char | 1 | Tipo de resgate. P – Parcial T – Total |
CartaoPermiteRecarga | Char | 1 | Permite Resgate. S – Sim N – Não |
ValorMinimoRecarga | Char | 12 | Valor mínimo para resgate. |
ValorMaximoRecarga | Char | 12 | Valor máximo para Resgate |
NomeResponsavel | Char | 25 | Nome do Cartao |
Cpf | Numeric | 14 | CPF/CNPJ responsável |
Matricula | Char | 10 | Matricula |
TipoConvenio | Char | 1 | Tipo de Convenio 1 – Pos 2 – Pre |
NomeEmpresaConveniada | Char | 40 | Nome do Convenio |
FlagValidacaoCartao | Char | 1 | Tipo de Validação do Cartao. 0 - não pede nada 1 - deve pedir 4 Últ. dígitos 2 - deve pedir CVV2 3 - deve pedir 4 Últ. dígitos e CVV2 4 - deve pedir senha 5 - deve pedir senha e 4 dígitos Últ. 6 - deve pedir senha e CVV2 7 - deve pedir senha, 4 Últ. e CVV2 |
QuantidadePlanos | Numeric | 2 | Quantidade de planos disponíveis |
CodigoPlanoPagamento | Numeric | 5 | Código do Plano |
NumeroParcelas | Numeric | 2 | Numero de Parcelas |
TaxaJuros | Char | 8 | Taxa de Juros |
FatorEntrada | Char | 8 | Fator de Entrada |
QuantidadeValoresFixos | Char | 2 | Quantidade de valores fixos |
ValoresFixos | Char | 40 | Valores Fixos |
Logradouro | Char | 40 | Nome do Logradouro |
Numero | Numeric | 10 | Numero |
Complemento | Char | 40 | Complemento |
Bairro | Char | 40 | Bairro |
Cidade | Char | 40 | Cidade |
Pais | Char | 3 | Sigla Pais |
Uf | Char | 2 | Sigla UF |
Cep | Numeric | 8 | CEP |
PercentualDescontoEvento | Numeric | 10 | Percentual de Desconto |
QuantidadeConvenios | Numeric | 2 | Quantidade de Convenios |
Convenios | Char | 40 | Lista Convenios |
ValorTotalTransacao | Char | 12 | -- DEPRECATED -- |
XML de Retorno
<ArrayOfRespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://grupolinx.com.br/">
<RespostaSAFE>
<CodigoResposta>00</CodigoResposta>
<NSUSafe>000000000</NSUSafe>
<MensagemPDV>TRANSAC APROVADA</MensagemPDV>
<SaldoDisponivel>200</SaldoDisponivel>
<Cartao>6394422000000006760</Cartao>
<TempoResposta>21979</TempoResposta>
<DataCarga>20160609</DataCarga>
<Validade>1706</Validade>
<DataUltimaRecarga>20160609</DataUltimaRecarga>
<TipoResgatePermitido>P</TipoResgatePermitido>
<CartaoPermiteRecarga>S</CartaoPermiteRecarga>
<ValorMinimoRecarga>000000000001</ValorMinimoRecarga>
<ValorMaximoRecarga>000000100000</ValorMaximoRecarga>
<NomeResponsavel>MARCOS ANTONIO DE CASTRO2</NomeResponsavel>
<Cpf>4209764426</Cpf>
<Matricula/>
<TipoConvenio>2</TipoConvenio>
<NomeEmpresaConveniada>CARTAO PRESENTE LEROY MERLIN</NomeEmpresaConveniada>
<FlagValidacaoCartao>0</FlagValidacaoCartao>
<QuantidadePlanos>01</QuantidadePlanos>
<CodigoPlanoPagamento>00002</CodigoPlanoPagamento>
<NumeroParcelas>01</NumeroParcelas>
<TaxaJuros>00000000</TaxaJuros>
<FatorEntrada>00000000</FatorEntrada>
<QuantidadeValoresFixos>05</QuantidadeValoresFixos>
<ValoresFixos>0000100000002500000050000001000000025000</ValoresFixos>
<Logradouro>RUA PIO IX</Logradouro>
<Numero>435</Numero>
<Complemento>1101</Complemento>
<Bairro>MADALENA</Bairro>
<Cidade>RECIFE</Cidade>
<Pais>BRA</Pais>
<Uf>PE</Uf>
<Cep>50710265</Cep>
<PercentualDescontoEvento></PercentualDescontoEvento>
<QuantidadeConvenios></QuantidadeConvenios>
<Convenios></Convenios>
<ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>
<RespostaSAFE>
<CodigoResposta>00</CodigoResposta>
<NSUSafe>000000000</NSUSafe>
<MensagemPDV>TRANSAC APROVADA</MensagemPDV>
<SaldoDisponivel>200</SaldoDisponivel>
<Cartao>6394422000000006760</Cartao>
<TempoResposta>21979</TempoResposta>
<DataCarga>20160609</DataCarga>
<Validade>1706</Validade>
<DataUltimaRecarga>20160609</DataUltimaRecarga>
<TipoResgatePermitido>P</TipoResgatePermitido>
<CartaoPermiteRecarga>S</CartaoPermiteRecarga>
<ValorMinimoRecarga>000000000001</ValorMinimoRecarga>
<ValorMaximoRecarga>000000100000</ValorMaximoRecarga>
<NomeResponsavel>MARCOS ANTONIO DE CASTRO2</NomeResponsavel>
<Cpf>4209764426</Cpf>
<Matricula/>
<TipoConvenio>2</TipoConvenio>
<NomeEmpresaConveniada>CARTAO PRESENTE LEROY MERLIN</NomeEmpresaConveniada>
<FlagValidacaoCartao>0</FlagValidacaoCartao>
<QuantidadePlanos>01</QuantidadePlanos>
<CodigoPlanoPagamento>00002</CodigoPlanoPagamento>
<NumeroParcelas>01</NumeroParcelas>
<TaxaJuros>00000000</TaxaJuros>
<FatorEntrada>00000000</FatorEntrada>
<QuantidadeValoresFixos>05</QuantidadeValoresFixos>
<ValoresFixos>0000100000002500000050000001000000025000</ValoresFixos>
<Logradouro>RUA PIO IX</Logradouro>
<Numero>435</Numero>
<Complemento>1101</Complemento>
<Bairro>MADALENA</Bairro>
<Cidade>RECIFE</Cidade>
<Pais>BRA</Pais>
<Uf>PE</Uf>
<Cep>50710265</Cep>
<PercentualDescontoEvento></PercentualDescontoEvento>
<QuantidadeConvenios></QuantidadeConvenios>
<Convenios></Convenios>
<ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>
</ArrayOfRespostaSAFE>
Compra de Cliente Convênio (B1)
Para realizar uma compra de um cliente de um convênio, deve-se utilizar o método: CompraParceladaConvenioB1
Parâmetros de entrada
Nome | Tipo | Tamanho | Descrição |
numeroCartao | String | 19 | Número do cartão do conveniado |
cvv | String | 5 | Código de segurança do cartão |
codigoEstabelecimento | String | 15 | Representa o código do estabelecimento.
ESTABELECIMENTO.CODIGO_ESTABELECIMENTO |
codigoEmpresa | String | 5 | Representa o código da empresa. Ex: 00001 |
codigoLoja | String | 4 | Representa o número da loja. Deve-se completar com zeros a esquerda. Ex: Loja 1 deve ser passado 0001 |
pdv | String | 3 | Representa o número do PDV Deve-se completar com zeros a esquerda. Ex: PDV 22 deve ser passado 022 |
valorTransacao | Double | 12,2 | Valor da transação |
valorEntrada | Double | 12,2 | Valor de entrada |
valorEncargos | Double | 12,2 | Valor dos encargos |
numeroCupom | String | 6 | Número do cupom |
horaLocal | String | 6 | Representa a hora local do PDV Mascara: hhmmss |
dataLocal | String | 4 | Representa a data local do PDV Mascara: MMDD |
codigoPlanoFinanceiro | Integer | 2 | Representa o código do plano financeiro |
tipoIdentificacao | Integer | 1 | Utilizado para identificar o conteúdo do campo numeroCartao Valores possíveis:
|
codigoEmpresaConveniada | Integer | 6 | Código da empresa conveniada |
cpfConveniado | String | 11 | CPF do conveniado |
matriculaConveniado | String | 10 | Matrícula do conveniado |
Parâmetros de Saída
Nome | Tipo | Tamanho | Descrição |
CodigoResposta | String | 2 | Código de Resposta da Transação. Vide item “Códigos de Resposta” no documento |
NSU Safe | String | 9 | NSU do SAFE
|
Mensagem PDV | String | 12 | Mensagem a ser exibida no PDV
|
Saldo Disponível | Numeric |
| Saldo disponível do cartão |
TextoCupom | String | 250 | Texto do Cupom |
Tempo de Resposta | Numeric | 6 | Tempo de resposta da transação |
NomeResponsavel | String | 40 | Nome do Cliente |
TipoConvenio | Char | 1 | Tipo do Convênio. 1 – Pós 2 – Pré (Cartao Presente/RT) 3 – Pat |
NumeroParcelas | Char | 2 | Numero de Parcelas da Transacao |
DescricaoFormaPagamento | Char | 20 | Descricao da forma de pagamento |
ValorVenda | Char | 12 | Valor da Transacao |
ValorEncargo | Char | 12 | Valor dos Encargos |
ValorParcelas | Char | 12 | Valor de cada parcela |
DataVencimentoPrimeiraParcela | Char | 8 | Data de Vencimento da primeira parcela. Máscara: AAAMMDD Utilizado na modalidade pós-pago |
CodigoCritica | Char | 2 | Código de Retorno da Crítica. |
CodigoEmpresaConveniada | Char | 6 | Código do Convênio |
EmpresaConveniada | String | 40 | Nome do Convênio |
NumeroCartao | Numeric | 19 | Numero do cartão |
ValorTotalTransacao | Numeric | 12 | -- DEPRECATED -- |
XML de Retorno
<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" [^] xmlns:xsd="http://www.w3.org/2001/XMLSchema" [^] xmlns="http://grupolinx.com.br/"> [^]
<CodigoResposta>00</CodigoResposta>
<NSUSafe>000078601</NSUSafe>
<MensagemPDV>TRANSAC APROV</MensagemPDV>
<SaldoDisponivel>9828</SaldoDisponivel>
<TextoCupom>
RESERVA TECNICA @ RESGATE @ DATA 14/07/2016 16:10:24@@ CUPOM: 000910@ CARTAO: 6394422000000008120@ ESTAB: 0001 @ LOJA: 0001 PDV: 651@@ VALOR RESGATE: 44,00@ SALDO DISPONIVEL: 9.828,00@ NSU_SAFE: 000078601@
</TextoCupom>
<TempoResposta>43531</TempoResposta>
<NomeResponsavel>MICHELLY</NomeResponsavel>
<TipoConvenio>2</TipoConvenio>
<NumeroParcelas>01</NumeroParcelas>
<DescricaoFormaPagamento>A VISTA</DescricaoFormaPagamento>
<ValorVenda>000000004400</ValorVenda>
<ValorEncargo>000000000000</ValorEncargo>
<ValorParcelas>000000000000</ValorParcelas>
<DataVencimentoPrimeiraParcela>00000000</DataVencimentoPrimeiraParcela>
<CodigoCritica>OK</CodigoCritica>
<CodigoEmpresaConveniada>000009</CodigoEmpresaConveniada>
<EmpresaConveniada>RT TESTE MICHELLY</EmpresaConveniada>
<NumeroCartao>6394422000000008120</NumeroCartao>
<ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>
Compra de Cliente Convênio V2 (B1)
Para realizar uma compra de um cliente de um convênio, utilizando cartão secundário e seu respectivo PIN, deve-se utilizar o método: CompraParceladaConvenioB1V2
Parâmetros de entrada
Nome | Tipo | Tamanho | Descrição |
numeroCartao | String | 19 | Número do cartão do conveniado |
cvv | String | 5 | Código de segurança do cartão |
codigoEstabelecimento | String | 15 | Representa o código do estabelecimento.
ESTABELECIMENTO.CODIGO_ESTABELECIMENTO |
codigoEmpresa | String | 5 | Representa o código da empresa. Ex: 00001 |
codigoLoja | String | 4 | Representa o número da loja. Deve-se completar com zeros a esquerda. Ex: Loja 1 deve ser passado 0001 |
pdv | String | 3 | Representa o número do PDV Deve-se completar com zeros a esquerda. Ex: PDV 22 deve ser passado 022 |
valorTransacao | Double | 12,2 | Valor da transação |
valorEntrada | Double | 12,2 | Valor de entrada |
valorEncargos | Double | 12,2 | Valor dos encargos |
numeroCupom | String | 6 | Número do cupom |
horaLocal | String | 6 | Representa a hora local do PDV Mascara: hhmmss |
dataLocal | String | 4 | Representa a data local do PDV Mascara: MMDD |
codigoPlanoFinanceiro | Integer | 2 | Representa o código do plano financeiro |
tipoIdentificacao | Integer | 1 | Utilizado para identificar o conteúdo do campo numeroCartao Valores possíveis:
|
codigoEmpresaConveniada | Integer | 6 | Código da empresa conveniada |
cpfConveniado | String | 11 | CPF do conveniado |
matriculaConveniado | String | 10 | Matrícula do conveniado |
numeroCartaoSecundario | String | 19 | Número do cartão secundário |
pinCartao | String | 10 | PIN do cartão secundário |
Parâmetros de Saída
Nome | Tipo | Tamanho | Descrição |
CodigoResposta | String | 2 | Código de Resposta da Transação. Vide item “Códigos de Resposta” no documento |
NSU Safe | String | 9 | NSU do SAFE
|
Mensagem PDV | String | 12 | Mensagem a ser exibida no PDV
|
Saldo Disponível | Numeric |
| Saldo disponível do cartão |
TextoCupom | String | 250 | Texto do Cupom |
Tempo de Resposta | Numeric | 6 | Tempo de resposta da transação |
NomeResponsavel | String | 40 | Nome do Cliente |
TipoConvenio | Char | 1 | Tipo do Convênio. 1 – Pós 2 – Pré (Cartao Presente/RT) 3 – Pat |
NumeroParcelas | Char | 2 | Numero de Parcelas da Transacao |
DescricaoFormaPagamento | Char | 20 | Descricao da forma de pagamento |
ValorVenda | Char | 12 | Valor da Transacao |
ValorEncargo | Char | 12 | Valor dos Encargos |
ValorParcelas | Char | 12 | Valor de cada parcela |
DataVencimentoPrimeiraParcela | Char | 8 | Data de Vencimento da primeira parcela. Máscara: AAAMMDD Utilizado na modalidade pós-pago |
CodigoCritica | Char | 2 | Código de Retorno da Crítica. |
CodigoEmpresaConveniada | Char | 6 | Código do Convênio |
EmpresaConveniada | String | 40 | Nome do Convênio |
NumeroCartao | Numeric | 19 | Numero do cartão |
ValorTotalTransacao | Numeric | 12 | -- DEPRECATED -- |
XML de Retorno
<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" [^] xmlns:xsd="http://www.w3.org/2001/XMLSchema" [^] xmlns="http://grupolinx.com.br/"> [^]
<CodigoResposta>00</CodigoResposta>
<NSUSafe>000078601</NSUSafe>
<MensagemPDV>TRANSAC APROV</MensagemPDV>
<SaldoDisponivel>9828</SaldoDisponivel>
<TextoCupom>
RESERVA TECNICA @ RESGATE @ DATA 14/07/2016 16:10:24@@ CUPOM: 000910@ CARTAO: 6394422000000008120@ ESTAB: 0001 @ LOJA: 0001 PDV: 651@@ VALOR RESGATE: 44,00@ SALDO DISPONIVEL: 9.828,00@ NSU_SAFE: 000078601@
</TextoCupom>
<TempoResposta>43531</TempoResposta>
<NomeResponsavel>MICHELLY</NomeResponsavel>
<TipoConvenio>2</TipoConvenio>
<NumeroParcelas>01</NumeroParcelas>
<DescricaoFormaPagamento>A VISTA</DescricaoFormaPagamento>
<ValorVenda>000000004400</ValorVenda>
<ValorEncargo>000000000000</ValorEncargo>
<ValorParcelas>000000000000</ValorParcelas>
<DataVencimentoPrimeiraParcela>00000000</DataVencimentoPrimeiraParcela>
<CodigoCritica>OK</CodigoCritica>
<CodigoEmpresaConveniada>000009</CodigoEmpresaConveniada>
<EmpresaConveniada>RT TESTE MICHELLY</EmpresaConveniada>
<NumeroCartao>6394422000000008120</NumeroCartao>
<ValorTotalTransacao>0</ValorTotalTransacao>
</RespostaSAFE>
Consulta Transação SAFE pelo NSU
Para realizar uma consulta de alguma transação do SAFE pelo NSU, deve-se utilizar o método: ConsultaTransacaoPeloNSUSafe
Parâmetros de entrada
Nome | Tipo | Tamanho | Descrição |
nsuSafe | String | 9 | NSU da transação a ser consultada |
Parâmetros de Saída
Nome | Tipo | Tamanho | Descrição |
CodigoResposta | String | 2 | Código de Resposta da Transação. Vide item “Códigos de Resposta” no documento |
NSU Safe | String | 9 | NSU do SAFE |
Mensagem PDV | String | 12 | Mensagem a ser exibida no PDV |
Saldo Disponível |
|
| --DEPRECATED— |
Tempo de Resposta | Numeric | 6 | Tempo de resposta da transação |
Número do Cartão | String | 19 | Número do cartão |
Código Mensagem Original | String | 4 | Código da mensagem (ISO) |
Data/Hora Transação Original | String | 10 | Data / Hora da transação. Máscara: MMDDHHMMSS |
Código do Estabelecimento | String | 15 | Representa o código do estabelecimento |
Valor Total Transação | Double | 12,2 | Valor da transação |
XML de Retorno
<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://grupolinx.com.br/">
<CodigoResposta>00</CodigoResposta>
<NSUSafe>000083235</NSUSafe>
<SaldoDisponivel>0</SaldoDisponivel>
<CodigoProcessamento>390060</CodigoProcessamento>
<TempoResposta>5239</TempoResposta>
<NumeroCartao>6394412000000000706</NumeroCartao>
<CodigoMensagemOriginal>0200</CodigoMensagemOriginal>
<DataHoraTransacaoOriginal>0308000000</DataHoraTransacaoOriginal>
<CodigoEstabelecimento>0001</CodigoEstabelecimento>
<ValorTotalTransacao>3.06</ValorTotalTransacao>
</RespostaSAFE>