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:

  1. Trilha 2 (Padrão);
  2. CPF;
  3. Matrícula Conveniado;
  4. Cartão 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

 

 

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

CodigoRespostaString2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU SafeString9NSU do SAFE
Mensagem PDVString12Mensagem a ser exibida no PDV
Saldo Disponível

Saldo disponível do cartão
Tempo de RespostaNumeric6Tempo 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:

  1. Trilha 2 (Padrão);
  2. CPF;
  3. Matrícula Conveniado;
  4. Cartão 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

 

 

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

CodigoRespostaString2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU SafeString9NSU do SAFE
Mensagem PDVString12Mensagem a ser exibida no PDV
Saldo Disponível

Saldo disponível do cartão
Tempo de RespostaNumeric6Tempo 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:

  1. Trilha 2 (Padrão);
  2. CPF (Utilizado exclusivamente para convênio pós-pago);
  3. Matrícula Conveniado;
  4. Cartão Conveniado.
  5. CPF (utilizado para convênio pré-pago)
  6. CNPJ (utilizado para convênio pré-pago)

 

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:

  1. Trilha 2 (Padrão);
  2. CPF;
  3. Matrícula Conveniado;
  4. Cartão Conveniado.

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:

  1. Trilha 2 (Padrão);
  2. CPF;
  3. Matrícula Conveniado;
  4. Cartão Conveniado.

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>