Callbacks

Aqui você encontrará mais detalhes sobre as funções de callbacks e imagens de exemplo para ilustrar o funcionamento

Display Terminal

Apresenta a mensagem solicitada pelo Client, no parâmetro pMensagem. Esta função apresenta mensagens gerais do fluxo da execução, como por exemplo “INSIRA OU PASSE O CARTAO”, “AGUARDE...”, “SOLICITANDO AUTORIZACAO” etc.

void DisplayTerminal(char *pMensagem)

Obs: esta função não possui retorno.

                                                      Exemplo: Tela implementada Display Terminal

Display Erro

Função utilizada para apresentar uma mensagem de erro no display, como por exemplo “CARTÃO INVÁLIDO”, “TENTE NOVAMENTE”. Se for um display gráfico, pode ser apresentado em vermelho para indicar a situação de erro. Em geral, é utilizado o mesmo local de apresentação da função Display Terminal, variando apenas a cor para indicar o erro. Isso entretanto pode ser desenvolvido da forma que melhor se adequar para a automação.

void DisplayErro(char *pMensagem)

Obs: esta função não possui retorno.

                                                        Exemplo: Tela implementada Display erro

Mensagem

Função utilizada para apresentar uma mensagem informativa na tela. É utilizada no fluxo das transações para apresentar dados ao usuário como por exemplo:

• O valor da transação
• Alguma opção que foi recentemente selecionada
• Mensagem retornada pela rede autorizadora.

void Mensagem(char *pMensagem)

Obs: esta função não possui retorno.

Beep

Comando enviado para o PDV para que este emita um sinal sonoro. O comando não possui nenhum parâmetro.

Obs: esta função não possui retorno.

void Beep()

Entra cartão

Comando para permitir que o operador digite o número do cartão.

int FormEntraCartao(char *pLabel, char *pCartao)

Retorno:

Observações:
• Neste campo, deverá ser permitido apenas a entrada de caracteres numéricos
• O tamanho máximo permitido para digitação será de 19 dígitos
• Deverá ser tomado o cuidado para que as informações de digitação do número do cartão não sejam armazenadas de forma aberta e/ou completa em nenhum local. As regras de segurança definidas pelo PCI não permitem o registro dos números de cartão.

Entra Data de validade

Comando para que o operador digite a data de validade do cartão no formato MMAA. Na tela, pode ser apresentado como MM/AA, mas no retorno a resposta não deverá conter os caracteres separadores.

int EntraDataValidade(char *pLabel, char *pDataValidade)

Retorno:

Observações:

Deverá ser tomado o cuidado para que as informações da data de validade do cartão não sejam armazenadas de forma aberta e/ou completa em nenhum local. As regras de segurança definidas pelo PCI não permitem o registro dessas informações.

Entra Data

Comando para que o operador digite a data de validade do cartão no formato MMAA. Na tela, pode ser apresentado como MM/AA, mas no retorno a resposta não deverá conter os caracteres separadores.

int EntraData(char *pLabel, char *pData)

Retorno:

Entra Código de segurança

Comando para que o operador digite o código de segurança do cartão. O número mínimo de caracteres permitido é 3 e o máximo é passado na função.

int EntraCodigoSeguranca(char *pLabel, char *pCodigoSeguranca, int iTamanhoMaximo)

Retorno:

Seleciona Opção

Comando para que seja apresentado ao operador um menu de opções e que assim seja selecionada uma dessas opções.

int SelecionaOpcao(char *pLabel, char *pOpcoes, int *iOpcaoSelecionada)

Entra Valor

Comando para que o operador entre com um valor numérico monetário, com 2 casas decimais.

int EntraValor(char *pLabel, char *pValor, char *pValorMinimo, char *pValorMaximo)

Entra Número

Comando para que o operador entre com um valor numérico monetário, com 2 casas decimais.

int EntraNumero(char *pLabel, char *pNumero, char *pNumeroMinimo, char *pNumeroMaximo, int iMinimoDigitos, int iMaximoDigitos, int iDigitosExatos)

Entra String

Comando para que o operador entre com uma string qualquer.

int EntraString(char *pLabel, char *pString, char *pTamanhoMaximo)

Mensagem Adicional

Apresenta a mensagem adicional enviada pelo concentrador TEF.

int MensagemAdicional(char *pMensagemAdicional) 

Obs:Retorno: O retorno desta função deverá ser 0.

Imagem Adicional

Apresenta uma imagem ou informação relacionada à rede selecionada pelo TEF Stone durante a transação. Apesar do nome da função fazer referência à apresentação de uma imagem, ela pode ser utilizada para apresentar somente o nome da rede autorizadora Esta função tem objetivo apenas informativo. Se não for implementada, não afetará o fluxo das transações.

int ImagemAdicional(int iIndiceImagem)

Obs:Retorno: O retorno desta função deverá ser 0.

Consulta AVS

Comando para que o operador entre com os dados da consulta AVS (transação de verificação de endereço).

int ConsultaAVS(char *cEndereco, char *cNumero, char *cApto, char *cBloco, char *cCEP, char  *cBairro, char *cCPF)

Mensagem Alerta

Apresenta uma mensagem de alerta enviada pelo concentrador TEF ao PDV. Não necessita de resposta, mas deverá esperar a confirmação da leitura pelo operador.

Atualmente, esta função é utilizada no momento de se desfazer uma transação, onde é apresentada uma mensagem indicando que a transação foi desfeita e o cupom deve ser retido. Por ser uma situação importante, é necessária a confirmação de leitura pelo operador.

void MensagemAlerta(char *pMensagemAlerta)

Obs:Retorno: O retorno desta função deverá ser 0.

Prévia do Comprovante

Apresenta um comprovante na tela. Isto acontece principalmente em transações de simulação de planos de pagamento, onde é feita apenas uma apresentação do resultado na tela, sem impressão do comprovante na impressora.

void PreviewComprovante(char *pComprovante)

Obs: Esta função não necessita de resposta, mas deverá aguardar a leitura dos dados por parte do operador, ou seja, deverá aguardar que o usuário tome alguma ação (pressione uma tecla, por exemplo).

Operação Cancelada

Retorna se a operação foi cancelada pelo operador. Esta função é chamada principalmente em operações com o pinpad, como por exemplo a passagem do cartão. Como essa passagem pode ser cancelada através da automação, se houver essa opção na automação e o usuário acioná-la enquanto o cartão estiver sendo lido, a operação será cancelada pelo client.

Essa função pode ser chamada múltiplas vezes durante a transação, principalmente durante a leitura de cartões. Quando a função retorna 1, o pinpad para a leitura e chama a função seguinte conforme o fluxo.

int OperacaoCancelada(void)

Obs: Esta função não necessita de resposta.

Seta Operação cancelada

Indica qual o valor que a função OperacaoCancelada deve inicializar. Se, por exemplo, a função OperacaoCancelada está indicando que a operação foi cancelada e a função SetaOperacaoCancelada for chamada com o valor 1, então a função OperacaoCancelada começará a indicar que a operação não foi mais cancelada (o valor foi reinicializado). Se o usuário indicar novamente que a operação foi cancelada, então a função OperacaoCancelada voltará a indicar que a operação foi cancelada, retornando o valor verdadeiro na função. Na prática, esta função serve para reinicializar o indicador de que a operação foi cancelada.

A implementação deste método consiste apenas em setar a variável de global de controle de operação cancelada para o valor do parâmetro.

int SetaOperacaoCancelada(int iCancelada)

Obs:O retorno desta função deverá ser 0.

Processa Mensagens

Indica para a automação executar processamento que esteja esperando o retorno de funções blocantes do client.

Exemplo: Ao passar o cartão no PinPad, o client fica aguardando a ação do operador. Para que a automação não fique “travada”, o client chama essa função para que ela execute procedimentos do tipo atualização de tela, horários e mensagens, processamento de teclado (para verificar se a operação foi cancelada). Esta função não possui parâmetros e também não tem retorno.

void ProcessaMensagens(void)

Seleciona Planos

Realiza a seleção dos planos de pagamento conforme os dados da transação.

int SelecionaPlanos(int iCodigoRede, int iCodigoTransacao, int iTipoFinanciamento, int
 iMaximoParcelas, char *pValorMinimoParcela, int iMaxDiasPreDatado, char *pNumeroParcelas,
 char *pValorTransacao, char *pValorParcela, char *pValorEntrada, char *pData)

Entra Valor Especial

Comando para que o operador entre com um valor numérico monetário, de acordo com as parametrizações.

int EntraValorEspecial(char *pLabel, char *pValor, char *pParametros)

Comandos

Comandos genéricos enviados do client. Quando necessário para executar uma transação poderá chamar este callback para que a automação execute alguma operação. Uma das situações onde isso é usado é na apresentação do QR Code para transações com carteiras digitais. Caso os comandos não sejam implementados, na medida do possível o client tentará processar o comando. Por exemplo, caso o comando de apresentação de QR Code não seja implementado o TEF exibirá uma tela com o QR Code mesmo que a integração seja feita com as telas da automação.

int Comandos(char *pDadosEntrada, char *pRetorno)

Comandos:

Solicita confirmação

Comando que força uma interação do operador solicitando uma confirmação ou não de uma determinada situação, pode ser enviado um texto no parâmetro pMensagem para ser exibido.

int SolicitaConfirmacao(char *pMensagem)