Plataforma de Comunicação Elgin versão 3.13.9
Documentação das bibliotecas de integração com hardware Elgin
Retorno ElginTEF IDH

Retono IDH Tef

Retorno para Compatibilidade Sitef

Chaves Descrição
COD_AUTORIZACAO Código de autorização da transação de crédito. (Presente somente em transações com cartão de crédito)
VIA_ESTABELECIMENTO Cupom referente à via do estabelecimento.
COMP_DADOS_CONF Dados que deverão ser passados para a CliSiTef, a fim de realizar a confirmação da transação realizada.
BANDEIRA Campo contendo a bandeira da transação TEF realizada. Os códigos estão no documento "Especificação Técnica –Interface com os meios de pagamento do SiTef", na Tabela de Código da Bandeira.
NUM_PARC Campo contendo a quantidade de parcelas da transação. Caso ele esteja ausente, ou tiver valor “0” ou “1”, considerar venda àvista.
REDE_AUT Campo contendo a rede autorizadora da transação TEF realizada. Os códigos estão no documento "Especificação Técnica –Interface com os meios de pagamento do SiTef", na Tabela de Código das RedesAutorizadoras.
NSU_SITEF NSU doservidor SiTef.
NSU_HOST NSU do Host Autorizador.
VIA_CLIENTE Cupom referente à via do cliente.
TIPO_PARC Valores possíveis:
00: À vista
01: Pré-Datado
02: ParceladoEstabelecimento
03: Parcelado Administradora
CODRESP Código de resposta da transação realizada com o SiTef.

Retornos Protocolo Elgin

Os retornos estarão sempre no seguinte formato:

{
"funcao": "<nome da função chamada>",
"mensagem": "<mensagem 'Sucesso' ou com descrição do erro>",
"resultado": "<chave com json de retorno da função>"
}

Nas descrições a seguir, as chaves que tiverem [Opcional] indica que são opcionais, e no caso de uma transação não bem sucedida podem não se encontrar no json de retorno.

Configuração

{
"funcao": string,
"mensagem": string,
"resultado": {
"mensagem": string
}
}

Ativação

{
"funcao": string,
"mensagem": string,
"resultado": { } // retorno vazio
}

Reimpressão

{
"funcao": string,
"mensagem": string,
"resultado": {
"mensagem": string, // [Opcional]
"administradora": string, // [Opcional]
"autorizacao": string, // [Opcional]
"data": string, // [Opcional]
"nsu": string, // [Opcional]
"nsuRede": string, // [Opcional]
"numeroCartao": string, // [Opcional]
"pagamento": string, // [Opcional]
"rede": string, // [Opcional]
"tipoCartao": string, // [Opcional]
"valor": string, // [Opcional]
"vencimento": string, // [Opcional]
"viaCliente": string, // [Opcional]
"viaEstabelecimento": string, // [Opcional]
"viaSMS": string, // [Opcional]
}
}

Relatório

{
"funcao": string,
"mensagem": string,
"resultado": {
"mensagem": string,
"relatorioTransacoes": string
}
}

Venda e Débito e Crédito

{
"funcao": string,
"mensagem": string,
"resultado": {
"mensagem": string,
"administradora": string, // [Opcional]
"autorizacao": string, // [Opcional]
"cnpjRede": string, // [Opcional]
"data": string, // [Opcional]
"nsu": string, // [Opcional]
"nsuRede": string, // [Opcional]
"numeroCartao": string, // [Opcional]
"pagamento": string, // [Opcional]
"rede": string, // [Opcional]
"tipoCartao": string, // [Opcional]
"valor": string, // [Opcional]
"vencimento": string, // [Opcional]
"viaCliente": string, // [Opcional]
"viaEstabelecimento": string, // [Opcional]
"viaSMS": string, // [Opcional]
}
}

Cancelamento

{
"funcao": string,
"mensagem": string,
"resultado": {
"mensagem": string,
"administradora": string, // [Opcional]
"cnpjRede": string, // [Opcional]
"data": string, // [Opcional]
"nsu": string, // [Opcional]
"nsuRede": string, // [Opcional]
"numeroCartao": string, // [Opcional]
"pagamento": string, // [Opcional]
"rede": string, // [Opcional]
"tipoCartao": string, // [Opcional]
"valor": string, // [Opcional]
"vencimento": string, // [Opcional]
"viaCliente": string, // [Opcional]
"viaEstabelecimento": string, // [Opcional]
"viaSMS": string, // [Opcional]
}
}