Skip to content

Tele-Marketing

Transação de Cartão de Crédito Direta (TeleMarketing)

int DIRETIVA_CALLBACK TransacaoCartaoCreditoConfirmada(char *pMultiLoja, char *pNumeroLoja, char *pNumeroPDV,
                                                       char *pValorTransacao, char *pNumeroCupom, char *pNumeroControle,
                                                       char *pNumeroCartao, char *pDataVencimento, char *pCVV2,
                                                       char *pTipoOperacao, char *pNumeroParcelas,
                                                       char *pValorTaxaServico, char *pMensagemTEF, char *pReservado)

int DIRETIVA_CALLBACK TransacaoCartaoCreditoIATAConfirmada(char *pMultiLoja, char *pNumeroLoja, char *pNumeroPDV,
                                                           char *pValorTransacao, char *pNumeroCupom,
                                                           char *pNumeroControle, char *pNumeroCartao,
                                                           char *pDataVencimento, char *pCVV2, char *pTipoOperacao,
                                                           char *pNumeroParcelas, char *pValorTaxaServico,
                                                           char *pValorEntrada, char *pMensagemTEF, char *pReservado)

Estas funções são realizadas mediante a chamada as funções TransacaoCartaoCreditoConfirmada e TransacaoCartaoCreditoIATAConfirmada com a passagem dos seguintes parâmetros:

  • MultiLoja
  • NumeroLoja
  • NumeroPDV
  • ValorTransacao
  • NumeroCupomVenda
  • NumeroControle
  • NumeroCartao
  • DataVencimento
  • CVV2
  • TipoOperacao
  • NumeroParcelas
  • ValorTaxaServico
  • ValorEntrada
  • MensagemTEF
  • Reservado

Na resposta da chamada à função serão preenchidos os campos NumeroControle e MensagemTEF e será devolvido o status, indicando o resultado da transação.

[ 00 ] indica que não existiram restrições para a efetivação da transação.
[ 11 ] indica que existiram restrições para a efetivação da transação. O sistema de automação deve retornar à rotina de recebimento de valores, pois a transação solicitada não foi autorizada, não sendo válida como forma de pagamento.

O NumeroControle , incluído na resposta, deverá ser armazenado pelo sistema de automação. Este número será utilizado para o sistema de automação buscar o arquivo que contém o comprovante de TEF.

Caso a transação seja autorizada, será disponibilizado no diretório corrente da DLL um arquivo contendo o comprovante da operação a ser impresso pela automação. O nome desse arquivo tem o formato NNNNNN.PPP, onde NNNNNN é o NumeroControle e PPP é o número do PDV passado como parâmetro. Este arquivo deverá obrigatoriamente ser eliminado do diretório assim que for impresso pela automação comercial.

Se a rede autorizadora permitir e se estiver configurada no TEF Linx a impressão de cupom reduzido, além do arquivo acima será liberado um arquivo com o comprovante reduzido no formato RNNNNNN.PPP, onde NNNNNN é o NumeroControle e PPP é o número do terminal configurado. Assim, o comprovante reduzido deverá ser impresso no espaço destinado à mensagem promocional do cupom fiscal e o comprovante normal continuará a ser impresso no cupom vinculado.

A confirmação da transação é feita de forma automática, sempre que a transação for concluída com sucesso ( = 00) .

Na chamada à função, deve-se informar os seguintes parâmetros:

Campo Tamanho Descrição
MultiLoja 01P 01 Caracter [‘S’,’N’]
NumeroLoja 04P 04 inteiros
NumeroPDV 03P 03 inteiros [001…356]
ValorTransacao 12P 10 inteiros, 2 decimais
NumeroCupomVenda 06P 06 inteiros
NumeroControle 06P 06 inteiros
NumeroCartao 19P 19 inteiros
DataVencimento 04P 04 inteiros
CVV2 05P Até 05 inteiros ou 1 Caracter [01..99999, ‘N’ (não existe), ‘I’ (ilegível)]
TipoOperacao 02P 02 Caracteres [‘AV’,’FA’,’FL’]
NumeroParcelas 02P 02 inteiros [00..99]
ValorTaxaServico 12P 10 inteiros, 2 decimais
ValorEntrada 12P 10 inteiros, 2 decimais
MensagemTEF 64P Mensagem de retorno do TEF Linx
Reservado 255P Campo Reservado

[Posição] Campo
[01..06] Código Autorização ¹
[07..10] Data Autorização [DDMM] ¹
[11..11] Versão do TEF Linx que autorizou; Permite os valores [ 5 ou 8 ]
[12..23] Valor da taxa de embarque ¹
[24..63] Descrição do produto ¹
[64..75] Código de referência ¹ ²
[76..78] ‘AVP’ que indica Alteração de Valor ou Parcelamento
[79..79] 'S' Se os campos de autenticação estiverem presentes nas transações e-Commerce
[80..81] Autenticação ECI - transações e-Commerce
[82..121] Autenticação XID - transações e-Commerce
[122..161] Autenticação UCAF - transações e-Commerce
[162..163] Quantidade de ciclos a pular
[164..168] Código da tabela dos planos CDC
[169..179] CPF do cliente

¹: Válido somente para transação TransacaoCartaoCreditoConfirmada.
²: Este código é apresentado no relatório de exportação do TEF Linx

Observação : Para cada chamada simultânea à função TransacaoCartaoCreditoConfirmada ou TransacaoCartaoCreditoIATAConfirmada deve ser informado um número de PDV diferente (obedecendo a faixa de PDVs definida na especificação dos parâmetros). Isto é necessário para que o TEF Linx possa diferenciar as transações que estão ocorrendo simultaneamente. Um exemplo de ocorrência desta situação é na utilização desta função através de um servidor Web, que pode ter vários usuários realizando acesso simultâneo.

Observação : para transações de telemarketing em ambientes com múltiplas threads simultâneas, deverá ser utilizada a DLL DPOSDRVTM.DLL.

Observação : Utilizar a opção ‘R’ no CVV2 somente para Crédito, não usar para Crédito IATA..

Observação : Se utilizado o parâmetro AVP, o campo Código e Data de Autorização deve ser o nsu e data da transação que terá seu valor e/ou parcela alterado (esta funcionalidade é utilizada atualmente pela GetNetLAC). É importante salientar que a transação que se deseja alterar valor e/ou parcela deve estar aprovada pela rede e pendente de confirmação no TEF Linx.

Para deixar a transação pendente em telemarketing recomenda-se utilizar a função ConfiguraModoTelemarketing (documentada mais abaixo), indicando o modo de confirmação manual.

Abaixo um exemplo de passos para fazer uma alteração de valor e/ou parcela com telemarketing:

1) Utilizar a função ConfiguraModoTelemarketing e setar confirmação manual.

2) Executar a Transação X de crédito telemarketing que seja aprovada pela rede autorizadora. Esta transação vai ficar pendente de confirmação.

3) Executar uma nova transação Y de crédito telemarketing, alterando valor e/ou parcela, e passando o nsu e data da transação X que está pendente.

4) Se resposta positiva da rede confirmar a transação Y.

5) Após a sequência acima a transação X ficará com status de “AJUSTE” e a transação Y com status “OK”. A transação Y é que será paga pela rede autorizadora.

Transação de Pré-Autorização de Cartão de Crédito Direta (Tele-Maketing)

int DIRETIVA_CALLBACK TransacaoCancelamentoConfirmada(char *pMultiLoja, char *pNumeroLoja, char *pNumeroPDV,
                                                      char *pValorTransacao, char *pNumeroControle, char *pNumeroCartao,
                                                      char *pMensagemTEF, char *pReservado)

Esta função é realizada mediante a chamada à função TransacaoCartaoCreditoConfirmada com a passagem dos seguintes parâmetros:

  • MultiLoja
  • NumeroLoja
  • NumeroPDV
  • ValorTransacao
  • NumeroControle
  • NumeroCartao
  • MensagemTEF
  • Reservado

Na resposta da chamada à função serão preenchidos os campos NumeroControle e MensagemTEF e será devolvido o status, indicando o resultado da transação.

[ 00 ] indica que não existiram restrições para a efetivação da transação.
[ 11 ] indica que existiram restrições para a efetivação da transação. O sistema de automação deve retornar à rotina de recebimento de valores, pois a transação solicitada não foi autorizada, não sendo válida como forma de pagamento.

O NumeroControle, incluído na resposta, deverá ser armazenado pelo sistema de automação. Este número será utilizado para o sistema de automação buscar o arquivo que contém o comprovante de TEF.Caso a transação seja autorizada, será disponibilizado no diretório corrente da DLL um arquivo contendo o comprovante da operação a ser impresso pela automação. O nome desse arquivo tem o formato NNNNNN.PPP, onde NNNNNN é o NumeroControle e PPP é o número do PDV passado como parâmetro. Este arquivo deverá obrigatoriamente ser eliminado do diretório assim que for impresso pela automação comercial.

A confirmação da transação é feita de forma automática, sempre que a transação for concluída com sucesso ( = 00) .

Na chamada à função, deve-se informar os seguintes parâmetros:

Campo Tamanho Descrição
MultiLoja 01P 01 Caracter [‘S’,’N’]
NumeroLoja 04P 04 inteiros
NumeroPDV 03P 03 inteiros [001…356]
ValorTransacao 12P 10 inteiros, 2 decimais
NumeroControle 06P 06 inteiros
NumeroCartao 19P 19 inteiros
MensagemTEF 64P Mensagem de retorno do TEF Linx
Reservado 255P Campo Reservado

[Posição] Campo
[01..01] Versão do TEF Linx que autorizou; Permite os valores [ 5 ou 8 ]
[02..13] Valor do cancelamento
[14..21] Data da transação a ser cancelada no formato [AAAAMMDD]
[22..25] Data de validade do cartão [MMAA]

Observação : Para cada chamada simultânea à função TransacaoCancelamentoConfirmada deve ser informado um número de PDV diferente (obedecendo a faixa de PDVs definida na especificação dos parâmetros). Isto é necessário para que o TEF Linx possa diferenciar as transações que estão ocorrendo simultaneamente. Um exemplo de ocorrência desta situação é na utilização desta função através de um servidor Web, que pode ter vários usuários realizando acesso simultâneo.

Observação : para transações de telemarketing em ambientes com múltiplas threads simultâneas, deverá ser utilizada a DLL DPOSDRVTM.DLL.

Transação de Pré-Autorização de Cartão de Crédito Direta (Tele-Maketing)

int DIRETIVA_CALLBACK PreAutorizacaoCreditoConfirmada(char *pMultiLoja, char *pNumeroLoja, char *pNumeroPDV,
                                                      char *pValorTransacao, char *pNumeroCupom, char *pNumeroControle,
                                                      char *pNumeroCartao, char *pDataVencimento, char *pCVV2,
                                                      char *pValorTaxaServico, char *pNumeroAutorizacao,
                                                      char *pMensagemTEF, char *pReservado)

Esta função é realizada mediante a chamada à função PreAutorizacaoCreditoConfirmada com a passagem dos seguintes parâmetros:

  • MultiLoja
  • NumeroLoja
  • NumeroPDV
  • ValorTransacao
  • NumeroCupomVenda
  • NumeroControle
  • NumeroCartao
  • DataVencimento
  • CVV2
  • ValorTaxaServico
  • NumeroAutorizacao
  • MensagemTEF
  • Reservado

Na resposta da chamada à função serão preenchidos os campos NumeroAutorizacao , NumeroControle e MensagemTEF e será devolvido o status, indicando o resultado da transação.

[ 00 ] indica que não existiram restrições para a efetivação da transação.
[ 11 ] indica que existiram restrições para a efetivação da transação. O sistema de automação deve retornar à rotina de recebimento de valores, pois a transação solicitada não foi autorizada, não sendo válida como forma de pagamento.

O NumeroControle, incluído na resposta, deverá ser armazenado pelo sistema de automação. Este número será utilizado para o sistema de automação buscar o arquivo que contém o comprovante de TEF.

O NumeroAutorizacao, incluído na resposta, deverá ser armazenado pelo sistema de automação. Este número é importante pois é o número da autorização da transação. É importante que o sistema apresente o número e a data da autorização ao usuário pois estes serão utilizados futuramente.

Caso a transação seja autorizada, será disponibilizado no diretório corrente da DLL um arquivo contendo o comprovante da operação a ser impresso pela automação. O nome desse arquivo tem o formato NNNNNN.PPP, onde NNNNNN é o NumeroControle e PPP é o número do PDV passado como parâmetro. Este arquivo deverá obrigatoriamente ser eliminado do diretório assim que for impresso pela automação comercial.

Se a rede autorizadora permitir e se estiver configurada no TEF Linx a impressão de cupom reduzido, além do arquivo acima será liberado um arquivo com o comprovante reduzido no formato RNNNNNN.PPP, onde NNNNNN é o NumeroControle e PPP é o número do terminal configurado. Assim, o comprovante reduzido deverá ser impresso no espaço destinado à mensagem promocional do cupom fiscal e o comprovante normal continuará a ser impresso no cupom vinculado.

A confirmação da transação é feita de forma automática, sempre que a transação for concluída com sucesso ( = 00) .

Na chamada à função, deve-se informar os seguintes parâmetros:

Campo Tamanho Descrição
MultiLoja 01P 01 Caracter [‘S’,’N’]
NumeroLoja 04P 04 inteiros
NumeroPDV 03P 03 inteiros [001…356]
ValorTransacao 12P 10 inteiros, 2 decimais
NumeroCupomVenda 06P 06 inteiros
NumeroControle 06P 06 inteiros
NumeroCartao 19P 19 inteiros
DataVencimento 04P 04 inteiros
CVV2 05P Até 05 inteiros ou 1 Caracter [01..99999, ‘N’ (não existe), ‘I’ (ilegível)]
ValorTaxaServico 12P 10 inteiros, 2 decimais
NumeroAutorizacao 02P 06 inteiros
MensagemTEF 64P Mensagem de retorno do TEF Linx
Reservado 255P Campo Reservado

[Posição] Campo
[01..01] Versão do TEF Linx que autorizou; Permite os valores [ 5 ou 8 ]
[02..13] Valor da taxa de embarque
[14..15] Tipo da Operação [‘AV’,’FA’,’FL’]
[16..17] Número de Parcelas

Observação : Para cada chamada simultânea à função PreAutorizacaoCreditoConfirmada deve ser informado um número de PDV diferente (obedecendo a faixa de PDVs definida na especificação dos parâmetros). Isto é necessário para que o TEF Linx possa diferenciar as transações que estão ocorrendo simultaneamente. Um exemplo de ocorrência desta situação é na utilização desta função através de um servidor Web, que pode ter vários usuários realizando acesso simultâneo.

Observação : Para transações de telemarketing em ambientes com múltiplas threads simultâneas, deverá ser utilizada a DLL DPOSDRVTM.DLL.

Transação de Confirmação Pre-Autorização Direta (Tele-Marketing)

int DIRETIVA_CALLBACK ConfPreAutorizacaoCreditoConfirmada(char *pMultiLoja, char *pNumeroLoja, char *pNumeroPDV,
                                                          char *pValorTransacao, char *pNumeroCupom,
                                                          char *pNumeroControle, char *pDataPreAutor,
                                                          char *pNumeroCartao, char *pDataVencimento, char *pCVV2,
                                                          char *pTipoOperacao, char *pNumeroParcelas,
                                                          char *pMensagemTEF, char *pReservado)

Está função é utilizada por algumas redes (Amex, Redecard e Getnet) para confirmar uma transação de Pré-Autorização feita previamente.

Esta transação é realizada mediante a chamada à função ConfPreAutorizacaoCreditoConfirmada com a passagem dos seguintes parâmetros:

  • MultiLoja
  • NumeroLoja
  • NumeroPDV
  • ValorTransacao
  • NumeroCupom
  • NumeroControle
  • DataPreAutor
  • NumeroCartao
  • DataVencimento
  • CVV2
  • TipoOperacao
  • NumeroParcelas
  • MensagemTEF
  • Reservado

Na resposta da chamada à função serão preenchidos os campos NumeroControle e MensagemTEF e será devolvido o status, indicando o resultado da transação.

[ 00 ] indica que não existiram restrições para a efetivação da transação.
[ 11 ] indica que existiram restrições para a efetivação da transação. O sistema de automação deve retornar à rotina de recebimento de valores, pois a transação solicitada não foi autorizada, não sendo válida como forma de pagamento.

O NumeroControle, incluído na resposta, deverá ser armazenado pelo sistema de automação. Este número será utilizado para o sistema de automação buscar o arquivo que contém o comprovante de TEF.

Caso a transação seja autorizada, será disponibilizado no diretório corrente da DLL um arquivo contendo o comprovante da operação a ser impresso pela automação. O nome desse arquivo tem o formato NNNNNN.PPP, onde NNNNNN é o NumeroControle e PPP é o número do PDV passado como parâmetro. Este arquivo deverá obrigatoriamente ser eliminado do diretório assim que for impresso pela automação comercial.

A confirmação da transação é feita de forma automática, sempre que a transação for concluída com sucesso ( = 00) .

Na chamada à função, deve-se informar os seguintes parâmetros:

Campo Tamanho Descrição
MultiLoja 01P 01 Caracter [‘S’,’N’]
NumeroLoja 04P 04 inteiros
NumeroPDV 03P 03 inteiros [001…356]
ValorTransacao 12P 10 inteiros, 2 decimais
NumeroCupom 06P 06 inteiros
NumeroControle 06P 06 inteiros
DataPreAutor 08P Data da Pré-Autorização a ser confirmada no formato [AAAAMMDD]
NumeroCartao 19P 19 inteiros
DataVencimento 04P 04 inteiros
CVV2 05P Até 05 inteiros ou 1 Caracter [01..99999, ‘N’ (não existe), ‘I’ (ilegível)]
TipoOperacao 02P 02 Caracteres [‘AV’,’FA’,’FL’]
NumeroParcelas 02P 02 inteiros [00..99]
MensagemTEF 64P Mensagem de retorno do TEF Linx
Reservado 255P Campo Reservado

[Posição] Campo
[01..01] Versão do TEF Linx que autorizou; Permite os valores [ 5 ou 8 ]

Transação de Consulta AVS (Tele-Marketing)

int DIRETIVA_CALLBACK TransacaoConsultaAVSConfirmada(char *pMultiLoja, char *pNumeroLoja, char *pNumeroPDV,
                                                     char *pNumeroCupom, char *pNumeroControle, char *pNumeroCartao,
                                                     char *pDataVencimento, char *pCVV2, char *pEndereco, char *pNumero,
                                                     char *pApto, char *pBloco, char *pCEP, char *pBairro, char *pCPF,
                                                     char *pMensagemTEF, char *pReservado)

Esta função é realizada mediante a chamada à função TransacaoConsultaAVSConfirmada com a passagem dos seguintes parâmetros:

  • MultiLoja
  • NumeroLoja
  • NumeroPDV
  • NumeroCupom
  • NumeroControle
  • NumeroCartao
  • DataVencimento
  • CVV2
  • Endereco
  • Numero
  • Apto
  • Bloco
  • CEP
  • Bairro
  • CPF
  • MensagemTEF
  • Reservado

Na resposta da chamada à função serão preenchidos os campos NumeroControle e MensagemTEF e será devolvido o status, indicando o resultado da transação.

O NumeroControle, incluído na resposta, deverá ser armazenado pelo sistema de automação. Este número será utilizado para o sistema de automação buscar o arquivo que contém o comprovante de TEF.

A confirmação da transação é feita de forma automática, sempre que a transação for concluída com sucesso ( = 00) .

Na chamada à função, deve-se informar os seguintes parâmetros:

Campo Tamanho Descrição
MultiLoja 01P 01 Caracter [‘S’,’N’]
NumeroLoja 04P 04 inteiros
NumeroPDV 03P 03 inteiros [001…356]
NumeroCupom 06P 06 inteiros
NumeroControle 06P 06 inteiros
NumeroCartao 19P 19 inteiros
DataVencimento 04P 04 inteiros
CVV2 05P Até 05 inteiros ou 1 Caracter [01..99999, ‘N’ (não existe), ‘I’ (ilegível)]
Endereço 40P
Numero 06P
Apto 05P
Bloco 02P
CEP 08P
Bairro 20P
CPF 11P
MensagemTEF 64P Mensagem de retorno do TEF Linx
Reservado 255P Campo Reservado

[Posição] Campo
[01..01] Versão do TEF Linx que autorizou; Permite os valores [ 5 ou 8 ]

Observação : Para cada chamada simultânea à função TransacaoConsultaAVSConfirmada deve ser informado um número de PDV diferente (obedecendo a faixa de PDVs definida na especificação dos parâmetros). Isto é necessário para que o TEF Linx possa diferenciar as transações que estão ocorrendo simultaneamente. Um exemplo de ocorrência desta situação é na utilização desta função através de um servidor Web, que pode ter vários usuários realizando acesso simultâneo.

Observação : Para transações de telemarketing em ambientes com múltiplas threads simultâneas, deverá ser utilizada a DLL DPOSDRVTM.DLL.

Outras Funções de Tele-Marketing

int DIRETIVA_CALLBACK ConfiguraModoTeleMarketing(int iModo)

int DIRETIVA_CALLBACK ConfirmaCartaoTeleMarketing(char *pMultiLoja, char *pNumeroLoja, char *pNumeroPDV,
                                                  char *pNumeroControle, char *pMensagemTEF, char *pReservado)

int DIRETIVA_CALLBACK DesfazCartaoTeleMarketing(char *pMultiLoja, char *pNumeroLoja, char *pNumeroPDV,
                                                char *pNumeroControle, char *pMensagemTEF, char *pReservado)

A função ConfiguraModoTeleMarketing parametriza o client para determinar se a confirmação deve ser enviada automaticamente (funcionalidade atual e default do sistema) ou se a aplicação integradora irá realizar a confirmação. As operações de confirmação e desfazimento são realizadas pelas funções ConfirmaCartaoTeleMarketing e DesfazCartaoTeleMarketing respectivamente. A transação ficará pendente no TEF Linx caso nenhuma destas funções forem chamadas para efetivar a transação.

Na chamada à função ConfiguraModoTeleMarketing , deve-se informar o(s) seguinte(s) parâmetro(s):

Campo Tamanho Descrição
Modo 01N [ 0 ] confirmação manual ( client não envia automaticamente a confirmação ao TEF Linx)
[ 1 ] confirmação automática ( client envia automaticamente a confirmação na chamada da transação)

[ 00 ] Indica que a configuração foi realizada.
[ 11 ] Configuração não realizada.

Na chamada às funções ConfirmaCartaoTeleMarketing ou DesfazCartaoTeleMarketing, deve-se informar os seguintes parâmetros:

Campo Tamanho Descrição
MultiLoja 01P 01 Caracter [‘S’,’N’]
NumeroLoja 04P 04 inteiros
NumeroPDV 03P 03 inteiros [001…356]
NumeroControle 06P 06 inteiros
MensagemTEF 64P Mensagem de retorno do TEF Linx
Reservado 255P Campo Reservado

[Posição] Campo
[01..01] Versão do TEF Linx que autorizou; Permite os valores [ 5 ou 8 ]

[ 00 ] indica que não existiram restrições para a efetivação da transação.
[ 11 ] indica que existiram restrições para a efetivação da transação. O sistema de automação deve retornar à rotina de recebimento de valores, pois a transação solicitada não foi autorizada, não sendo válida como forma de pagamento.

Observação : para transações de telemarketing em ambientes com múltiplas threads simultâneas, deverá ser utilizada a DLL DPOSDRVTM.DLL.