Histórico da Página
CONTEÚDO
- Visão Geral
- Funcionalidades
- Configuração
- Utilização
- Autorização de Pagamento para Crédito ou DébitoDigital
- Cancelamento de Venda
- Estorno de Transação
- Reimpressão de Comprovante
- Solicitação de CPF no Terminal
- Autorização de Pagamento para Crédito ou DébitoDigital
- 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 | ||||
---|---|---|---|---|
|
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 | |||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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> |