Histórico da Página

CONTEÚDO

Visão Geral
Funcionalidades
Configuração
Utilização
1. Autorização de Pagamento para Crédito ou DébitoDigital
2. Cancelamento de Venda
3. Estorno de Transação
4. Reimpressão de Comprovante
5. Solicitação de CPF no Terminal
Dicionário de Dados
Tabelas utilizadas

01. VISÃO GERAL

Esta implementação tem como objetivo realizar transações de cartão de crédito e débito através da API denominada Payment Hub (Hub de Pagamentos)

O componente é baseado na implementação do Payment Hub como ferramenta de TEF, possibilitando direcionar os pagamentos para um ambiente de transações eletrônicas centralizado.

O Payment Hub no presente momento disponibiliza apenas as API’s para transação de cartão de crédito (à vista e parcelado em até 12 vezes) e cartão de débito (à vista), portanto somente estas modalidades foram implementadas.

Está contemplado neste projeto, a identificação automática de Administradora Financeira que é gravada na tabela SL4 de acordo com o código de retorno da bandeira do cartão utilizado na transação TEF, com base nas configurações pré-definidas no cadastro de Administradora Financeira relacionada com o código de retorno conforme especificação de códigos de retorno da empresa processadora da transaçãopagamento com Carteiras Digitais.

Card documentos

Informacao	Essa funcionalidade está disponível apenas para o TOTVS PDV.
Titulo	IMPORTANTE!

02. FUNCIONALIDADES

Venda com Pagamentos em Cartão de Crédito ou Débitocom Carteiras Digitais.
Cancelamento de Venda
Reimpressão de Comprovante
Seleção de Terminal
Estorno de Transação
Solicitação de CPF pelo Terminal.

03. CONFIGURAÇÃO

Cadastro de Estação:

Através da nova guia Payment Hub disponível na Totvs Pagamentos Digitais disponível na tela de configuração do TEF no cadastro de Estação (LOJA121), é possível realizar a configuração para habilitar o uso desta implementação.

Essa implementação faz uso da solução Totvs RAC para autenticação e atribuição de autorizações desse serviço.

Card documentos

Informacao	Os dados de acesso/configuração do Totvs RAC devem ser obtidas junto ao departamento responsável da Totvs.
Titulo	IMPORTANTE!

Após ter os dados de configuração do Totvs RAC, basta informá-los nos campos, conforme demonstrado abaixo, para obtenção do token no momento de uso desta funcionalidade.

Campos

Campo	Descrição
Companhia (MDG_PHCOMP)	Código da companhia. Esse código é responsável por vincular o Hub de Pagamentos ao adquirente.
Tenant (MDG_PHTENA)	Código de Tenant. Este código é o identificador da sua empresa no Totvs RAC.
Usuário (MDG_PHUSER)	Código do usuário do Totvs RAC que solicitará o token de acesso para utilização do Hub de Pagamentos.
Senha (MDG_PHPSWD)	Senha para acesso ao ambiente do Totvs RAC.
Client ID (MDG_PHCLID)	Código do produto que será validado no Totvs RAC.
Cli. Secret (MDG_PHCLSR)	Senha do produto que será validado no Totvs RAC.
Terminal (MDG_PHTERM)	Código do terminal TEF utilizado nas transações do Hub de Pagamentos.
Cartão Crédito/Débito (MDG_PHCCCD)	Habilita ou desabilita operações de transação com cartão de crédito e débito.
Pagamento Digital ()	Habilita ou desabilita operações de transação com pagamento digital.

04. UTILIZAÇÃO

Abaixo, em cada aba está disponível através de ilustrações como são realizadas as operações utilizando esta implementação.

Totvs custom tabs box

tabs	Venda com Cartão de Crédito ou Débito, Cancelamento de Venda, Reimpressão de Comprovante, Seleção de Terminal, Estorno de Transação,CPF pelo Terminal
ids	passo1,passo2,passo3,passo4,passo5,passo6

Totvs custom tabs box items

default	yes
referencia	passo1

A seguir temos as ilustrações demonstrando o processo de uma venda, onde o pagamento foi realizado com Cartão de Crédito (para Cartão de Débito, o procedimento é o mesmo, bastando apenas selecionar a forma de pagamento Cartão de Débito).

Image Removed

Caso o terminal não seja informado na configuração do TEF no cadastro de estação, é apresentada a tela com a lista de terminais disponíveis para utilização que estejam conectados no momento. Deve ser selecionado um terminal para que a transação TEF seja realizada.

Image Removed

Se desejar utilizar o mesmo terminal para as próximas operações, basta selecionar a opção de checkbox para manter o terminal selecionado, conforme demonstrado na imagem anterior. Caso essa opção não seja selecionada, toda vez será apresentada a tela solicitando que seja selecionado um terminal para realizar a operação.

Image Removed

O comprovante da transação TEF é impresso:

Image Removed

Pagamento Digital.

Card documentos

Informacao	Para que o sistema faça a gravação automática da Administradora Financeira na tabela SL4 com base no código de retorno da bandeira, é necessário estar devidamente relacionado o código de retorno na configuração das Administradoras Financeiras.
Titulo	IMPORTANTE!

Totvs custom tabs box items

default	no
referencia	passo2

Quando for realizado o cancelamento da venda cujo pagamento foi realizado com cartão de crédito ou débito, será solicitado o cancelamento da(s) transação(ões) TEF desta venda automaticamente. Veja:

Image Removed

O comprovante de canelamento da transação TEF é impresso:

Image Removed

Totvs custom tabs box items

default	no
referencia	passo3

É possível realizar a Reimpressão de Comprovante da Transação do Cartão, através do Menu F2, opção TEF - Gerenciais.

Image Removed

Informe o código do cupom/doc:Image Removed

Na próxima tela será(ão) apresentada(s) a(s) transação(ões) TEF relacionada(s) aquele cupom/doc. Basta selecionar a transação que deseja reimprimir e confirmar.Image Removed

O comprovante da transação é impresso.

Image Removed

Totvs custom tabs box items

default	no
referencia	passo4

Através do Menu F2, opção TEF - Gerenciais, pode ser selecionado o terminal que deseja realizar as operações TEF. Ao escolher um terminal através desta opção, este terminal ficará pré-selecionado enquanto estiver com o sistema aberto. Ao sair do sistema e acessá-lo novamente, voltará a considerar a configuração do terminal que estiver definido no cadastro de estação na configuração do TEF, na aba Payment Hub. Caso não tenha um terminal definido no cadastro, o sistema apresentará a tela para selecionar um terminal no momento que for realizada uma operação TEF.

Image Removed

O sistema busca os terminais disponíveis para utilização que estejam conectados no momento.Image Removed

É apresentada a tela com a lista de terminais disponíveis. Basta selecionar o terminal desejado e confirmar.Image Removed

Após selecionado o terminal, o sistema utilizará este terminal para realizar as próximas transações TEF.

Totvs custom tabs box items

default	no
referencia	passo5

É possível realizar o estorno individual da transação do cartão, através do Menu F2, opção TEF - Gerenciais.Image Removed

Informe o código do cupom/doc:

Image Removed

Na próxima tela será(ão) apresentada(s) a(s) transação(ões) TEF relacionada(s) aquele cupom/doc. Basta selecionar a transação que deseja estornar e confirmar.

Image Removed

Caso o terminal não seja informado na configuração do TEF no cadastro de estação, é apresentada a tela com a lista de terminais disponíveis para utilização que estejam conectados no momento. Deve ser selecionado um terminal para que a operação de estorno seja realizada.Image Removed

A transação é cancelada.

Image Removed

O comprovante do cancelamento é impresso:

Image Removed

Totvs custom tabs box items

default	no
referencia	passo6

O CPF do cliente da venda pode ser informado via terminal através do botão CPF via PinPad disponível na tela do Totvs PDV.

Aviso

title	Importante!

É necessário estar com o parâmetro MV_LJDGCPF devidamente configurado para permitir digitar o CPF através do PinPad.

Image Removed

O CPF do cliente é solicitado no terminal.Image Removed

Após digitado no terminal, o campo de CPF é alimentado.Image Removed

Basta prosseguir com a venda normalmente.

05. DICIONÁRIO DE DADOS

Campos (SX3) - Tabela MDG

Campos novos:

Campo	MDG_PHCOMP
Tipo	Caractere
Tamanho	8
Decimal	0
Título	Companhia
Descrição	Código da Companhia
Help	Código da companhia. Esse código é responsável por vincular o Hub de Pagamentos ao adquirente.

Campo	MDG_PHTENA
Tipo	Caractere
Tamanho	250
Decimal	0
Título	Tenant
Descrição	Tenant
Help	Código de Tenant. Este código é o identificador da sua empresa no TOTVS RAC.

Campo	MDG_PHUSER
Tipo	Caractere
Tamanho	100
Decimal	0
Título	Usuário
Descrição	Usuário
Help	Código do usuário do TOTVS RAC que solicitará o token de acesso para utilização do Hub de Pagamentos.

Campo	MDG_PHPSWD
Tipo	Caractere
Tamanho	100
Decimal	0
Título	Senha
Descrição	Senha
Help	Senha para acesso ao ambiente do TOTVS RAC.

Campo	MDG_PHCLID
Tipo	Caractere
Tamanho	250
Decimal	0
Título	Client ID
Descrição	Client ID
Help	Código do produto que será validado no TOTVS RAC.

Campo	MDG_PHCLSR
Tipo	Caractere
Tamanho	250
Decimal	0
Título	Cli. Secret
Descrição	Client Secret
Help	Senha do produto que será validado no TOTVS RAC.

Campo	MDG_PHTERM
Tipo	Caractere
Tamanho	100
Decimal	0
Título	Terminal
Descrição	Código do Terminal
Consulta Padrão	TTEFPH
Help	Código do terminal TEF utilizado nas transações do Hub de Pagamentos.

Campo	MDG_PHCCCD
Tipo	Caractere
Tamanho	1
Decimal	0
Título	Hab.Cart.Hub
Descrição	Habilita Trans Cartão Hub
Opções	1=Sim;2=Não
Help	Habilita transações em crédito/débito pelo Hub de Pagamentos do Varejo.

Campos (SX3) - Tabela SL4

Campos novos:

Campo	L4_TRNID
Tipo	Caractere
Tamanho	100
Decimal	0
Título	ID Transação
Descrição	ID da Transação
Help	Id da transação do Payment Hub

Campo	L4_TRNPCID
Tipo	Caractere
Tamanho	100
Decimal	0
Título	ID Trn. Proc
Descrição	ID Transação Processador
Help	Id da transação do processador do Payment Hub.

Campo	L4_TRNEXID
Tipo	Caractere
Tamanho	100
Decimal	0
Título	ID Trn. Ext.
Descrição	ID da Transação Externa
Help	Id externa da transação do Payment Hub.

Campos alterados:

Campo	L4_BANDEIR
Tamanho	40

Campo	L4_REDEAUT
Tamanho	40

Campos (SX3) - Tabela SAE

Campo alterado:

Campo	AE_ADMCART
Descrição	Cod. Retorno da Bandeira

Campos (SX3) - Tabela MDE

Campo novo:

Campo	MDE_ORIGEM
Tipo	Caractere
Tamanho	1
Decimal	0
Título	Orig.Retorno
Descrição	Origem Código de Retorno
Opções	1=Sitef;2=Adyen
Help	Indica a origem do código de retorno.

Campos alterados:

Campo	MDE_CODSIT
Tamanho	40
Título	Cód. Retorno
Descrição	Código de Retorno

Campo	MDE_DESC
Tamanho	60
Título	Descrição
Descrição	Descr. como especificado

Campo	MDE_TIPO
Título	Tipo Retorno
Descrição	Tipo de Retorno

Consulta Padrão (SXB)

Consulta nova:

Consulta Padrão	TTEFPH
Tipo de consulta	Específica
Descrição	Cons. Terminal
Expressão	LjPHSelTer()
Retorno	LjPHGetTer()

06. TABELAS UTILIZADAS

MDE - Códigos de Retorno TEF
MDG - Configurador TEF
SAE - Administração Financeira
SL4 - Condição Negociada
SLG - Estações

HTML

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave

CONTEÚDO

02. FUNCIONALIDADES

03. CONFIGURAÇÃO

04. UTILIZAÇÃO