Histórico

Versão Publicado Alterado Por Comentar
ATUAL (v. 1) jun 01, 2021 10:58
Mario Jorge Azevedo Santos


Consulta Gift Card

Para consultar um Gift Card, deve-se utilizar o seguinte método: ConsultaGiftCardD5

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

numeroCartao

String

19

Número do Cartão a ser consultado.

Caso seja um cancelamento de Emissão ou Resgate de VT, deve-se passar o valor 7850000000000000000

codigoEmpresa

String

15

Representa o código do estabelecimento.

ESTABELECIMENTO.CODIGO_ESTABELECIMENTO

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

 

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

NSUSafe

String

9

NSU SAFE da Transação

MensagemPDV

String

16

Mensagem a ser exibida no terminal

SaldoDisponivel

Double

12,2

Saldo Disponível no Cartao

Cartao

String

19

Número do Cartão Consultado

TempoResposta

Numeric

6

Tempo de Resposta da Transação

DataCarga

String

10

Data da primeira carga.

Máscara: AAAAMMDD

Validade

String

4

Data de Validade do Cartao.

Máscara: AAMM

DataUltimaRecarga

String

14

Data/hora da última transação de recarga.

Máscara: AAAAMMDDHHMMSS

TipoResgatePermitido

Char

1

Tipo de Resgate permitido para o cartão.

T – Total

P – Parcial

CartaoPermiteRecarga

Char

1

Flag que indica se o cartão pode ou não ser recarregado.

S – Sim

N – Não

CartaoPermiteValorVariavel

Char

1

-- DEPRECATED --

ValorMinimoRecarga

String

12

Valor mínimo para transação de resgate.

000000000001 representa R$ 0,01

ValorMaximoRecarga

String

12

Valor máximo para transação de resgate.

000000100000 representa R$ 1000,00

NomeResponsavel

String

50

Nome do Responsável*

* Utilizado na modalidade Voucher


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>000074193</NSUSafe>

<MensagemPDV>TRANSAC APROVADA</MensagemPDV>

<SaldoDisponivel>177</SaldoDisponivel>          

<Cartao>6394412000000001027</Cartao>

<TempoResposta>5984</TempoResposta>

<DataCarga>20151207</DataCarga>

<Validade>1612</Validade>

<DataUltimaRecarga>20151207152148</DataUltimaRecarga>

<TipoResgatePermitido>T</TipoResgatePermitido>   

<CartaoPermiteRecarga>S</CartaoPermiteRecarga>

<CartaoPermiteValorVariavel>S</CartaoPermiteValorVariavel>

<ValorMinimoRecarga>000000000001</ValorMinimoRecarga>   

<ValorMaximoRecarga>000000100000</ValorMaximoRecarga>

<NomeResponsavel>0000000000CLIENTE CONV PRE-PG</NomeResponsavel>

</RespostaSAFE>



Resgate (Utilização) Gift Card

Para regatar (utilizar) um Gift Card, deve-se utilizar o seguinte método: ResgateGiftCardD3

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

numeroCartao

String

19

Número do Cartão a ser consultado.

valor

Double

12,2

Valor de Transação

horaLocal

String

6

Representa a hora local do PDV

Mascara: hhmmss

dataLocal

String

4

Representa a data local do PDV

Mascara: MMDD

codigoEmpresa

String

15

Representa o código do estabelecimento.

 

ESTABELECIMENTO.CODIGO_ESTABELECIMENTO

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

numeroCupom

String

6

Número do cupom de troca.

Deve-se completar com zeros a esquerda.

vencimentoCartao

String

4

Data de Vencimento do Cartão

Máscara: AAMM

dataReferencia

String

4

Data da Transação

Máscara: MMDD

 

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

NSUSafe

String

9

NSU SAFE da Transação

MensagemPDV

String

16

Mensagem a ser exibida no terminal

SaldoDisponivel

Double

12,2

Saldo do cartão após o resgate

TextoCupom

String

260

Texto do cupom impresso no PDV.

O caracter @ significa quebra de linha.

Cartao

String

19

Número do Vale-Troca gerado

TempoResposta

Numeric

6

Tempo de Resposta da Transação

DataHoraTransacao

String

10

Data/Hora da Transação realizada.

Máscara: MMDDHHMMSS


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>000073430</NSUSafe>

    <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

    <SaldoDisponivel>50</SaldoDisponivel>

    <TextoCupom> CARTAO PRE-PAGO@ COMPRA/RESGATE@ DATA: 03/03/2016 HORA: 16:07:05 @ESTAB: 0001 @CPF: 00000000000 @NSU_SAFE:000073455 APROV: 907857 @VALOR DA COMPRA: 1 SALDO ATUAL: 14@LOJA: 0001 PDV: 001 </TextoCupom>

    <Cartao>6394412000000001027</Cartao>

    <TempoResposta>741</TempoResposta>

    <DataHoraTransacao>0303095615</DataHoraTransacao>

</RespostaSAFE>



Realizar Carga Credito (D1)

Para realizar um resgate de crédito (pagamento) de um giftcard, deve-se utilizar o método: CargaGiftCardD1

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

numeroCartao

String

19

Número do cartão do giftcard

valor

Double

12,2

Valor do crédito

horaLocal

String

6

Representa a hora local do PDV

Mascara: hhmmss

dataLocal

String

4

Representa a data local do PDV

Mascara: MMDD

codigoEstabelecimento

String

15

Representa o código do estabelecimento

codigoEmpresa

String

4

Código da empresa

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

Número do PDV

numeroDoCupom

String

6

Número do cupom

numeroCampanha

Integer

6

--DEPRECATED--

 

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

Double

12,2

Saldo disponível da lista 

Texto do cupom

String

999

Texto do cupom a ser impresso

Número do Cartão

String

19

Número do cartão 

Tempo de Resposta

Numeric

6

Tempo de resposta da transação 

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação 

  

XML de Retorno quando passar 0 (zero) no idLista

<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>000083246</NSUSafe>

    <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

    <SaldoDisponivel>29</SaldoDisponivel>

    <TextoCupom>CARTAO PRE-PAGO @ RECARGA@ DATA: 03/03/2016 HORA: 16:07:05@ ESTAB: 0001 @ CARTAO:6392472000000000002@ NSU_SAFE:000083246 APROV: 109817@ VALOR DA RECARGA: 15,50@ SALDO ATUAL: 29,00@ @ LOJA: 0001 PDV: 001@</TextoCupom>

    <Cartao>6392472000000000002</Cartao>

    <TempoResposta>5900</TempoResposta>

    <DataHoraTransacao>0303160705</DataHoraTransacao>

    <ValorTotalTransacao>0</ValorTotalTransacao>

</RespostaSAFE>



Realizar Carga Credito V2 (D1)

Para realizar um resgate de crédito (pagamento) de um giftcard, utilizando o cartão secundário e seu respectivo PIN, deve-se utilizar o método: CargaGiftCardD1V2

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

numeroCartao

String

19

Número do cartão do giftcard

valor

Double

12,2

Valor do crédito

horaLocal

String

6

Representa a hora local do PDV

Mascara: hhmmss

dataLocal

String

4

Representa a data local do PDV

Mascara: MMDD

codigoEstabelecimento

String

15

Representa o código do estabelecimento

codigoEmpresa

String

4

Código da empresa

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

Número do PDV

numeroDoCupom

String

6

Número do cupom

numeroCampanha

Integer

6

--DEPRECATED--

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

Double

12,2

Saldo disponível da lista 

Texto do cupom

String

999

Texto do cupom a ser impresso

Número do Cartão

String

19

Número do cartão 

Tempo de Resposta

Numeric

6

Tempo de resposta da transação 

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação 

  

XML de Retorno quando passar 0 (zero) no idLista

<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>000083246</NSUSafe>

    <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

    <SaldoDisponivel>29</SaldoDisponivel>

    <TextoCupom>CARTAO PRE-PAGO @ RECARGA@ DATA: 03/03/2016 HORA: 16:07:05@ ESTAB: 0001 @ CARTAO:6392472000000000002@ NSU_SAFE:000083246 APROV: 109817@ VALOR DA RECARGA: 15,50@ SALDO ATUAL: 29,00@ @ LOJA: 0001 PDV: 001@</TextoCupom>

    <Cartao>6392472000000000002</Cartao>

    <TempoResposta>5900</TempoResposta>

    <DataHoraTransacao>0303160705</DataHoraTransacao>

    <ValorTotalTransacao>0</ValorTotalTransacao>

</RespostaSAFE>



Gerar Cartão Giftcard


Para gerar um cargão giftcard, deve-se utilizar o método: GerarCartaoGiftcard.

  • Sem rótulos