01. VISÃO GERAL
Esta implementação tem como objetivo realizar transações de pagamento com Carteiras Digitais.
Cadastro de Estação:
Através da nova guia 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.

Forma de Pagamento: Após realizar o cadastro na estação, deverá ser criada as novas Formas de Pagamentos para a utilização das Carteiras Digitais, uma para os Pagamentos Digitais (Carteiras) e outra para o PIX. Para criação, siga a orientação do documento Cadastro de nova forma de pagamento
|
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 PDV ao Totvs Pagamento Digital. |
| 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 Totvs Pagamento Digital . |
| Senha (MDG_PHPSWD) | Senha para acesso ao ambiente do Totvs RAC. |
| Client ID (MDG_PHCLID) | Código do produto disponível no TOTVS RAC vinculado à funcionalidade do Totvs Pagamento Digital. |
| Cli. Secret (MDG_PHCLSR) | Senha do produto disponível no TOTVS RAC vinculado à funcionalidade do Totvs Pagamento Digital. |
| Pagamento Digital (MDG_PHPAGD) | 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.
|
05. DICIONÁRIO DE DADOS
Parâmetro novo:
Nome do Parâmetro | MV_NATPGDG |
|---|---|
| Tipo | Caractere |
| Descrição | Determina qual a natureza será utilizada na geração de titulo referente a venda c/ Pagamento Digital |
| Valor padrão | "PAGDIGITAL" |
Nome do Parâmetro | MV_NATPGPX |
|---|---|
| Tipo | Caractere |
| Descrição | Determina qual a natureza será utilizada na geração de titulo referente a venda c/ Pagamento via PIX |
| Valor padrão | "PIX" |
As naturezas "PAGDIGITAL" e "PAGTOPIX" são criadas automaticamente ao acessar o sistema Controle de Lojas (SIGALOJA), caso o sistema esteja atualizado com o pacote desta funcionalidade. Se preferir, podem ser criadas as naturezas de sua preferência e associá-la aos parâmetros MV_NATPGDG e MV_NATPGPX. Essa configuração de natureza é necessária apenas no ambiente da Retaguarda (incluindo ambiente onde é executado o Job LjGrvBatch) ou em ambiente onde são utilizadas as rotinas Venda Assistida ou Venda Direta. No ambiente do Totvs PDV não é necessário fazer essa configuração. |
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 Totvs Pagamento Digital 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 Totvs Pagamento Digital . |
| 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 disponível no TOTVS RAC vinculado à funcionalidade do Totvs Pagamento Digital. |
| Campo | MDG_PHCLSR |
|---|---|
| Tipo | Caractere |
| Tamanho | 250 |
| Decimal | 0 |
| Título | Cli. Secret |
| Descrição | Client Secret |
| Help | Senha do produto disponível no TOTVS RAC vinculado à funcionalidade do Totvs Pagamento Digital. |
| Campo | MDG_PHPAGD |
|---|---|
| Tipo | Caractere |
| Tamanho | 1 |
| Decimal | 0 |
| Título | Pgto.Digital |
| Descrição | Habilita Pagto. Digital |
| Opções | 1=Sim;2=Não |
| Help | Habilita/desabilita transações de Pagamentos Digitais pelo Totvs Pagamento Digital do Varejo. |
Campo novo:
Campo | L1_VLRPGDG |
|---|---|
| Tipo | Numérico |
| Tamanho | 15 |
| Decimal | 2 |
| Título | Vlr.Pag.Dig. |
| Descrição | Total em Pagto. Digital |
| Help | Valor pago em Pagamento Digital. |
Campos novos:
Campo | LV_TRNID |
|---|---|
| Tipo | Caractere |
| Tamanho | 100 |
| Decimal | 0 |
| Título | ID Transação |
| Descrição | ID da Transação |
| Help | Id da transação do Totvs Pagamento Digital. |
Campo | LV_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 Totvs Pagamento Digital. |
Campo | LV_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 Totvs Pagamento Digital. |
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 Totvs Pagamento Digital. |
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 Totvs Pagamento Digital. |
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 Totvs Pagamento Digital. |
Campos alterados:
Campo | L4_BANDEIR |
|---|---|
| Tamanho | 40 |
Campo | L4_REDEAUT |
|---|---|
| Tamanho | 40 |
Campo alterado:
Campo | AE_ADMCART |
|---|---|
| Título | Bandeira |
| Descrição | Cod. Retorno da Bandeira |
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 |
| Opções | CC=Crédito;CD=Débito;RD=Rede;PD=Pagamento Digital |
06. TABELAS UTILIZADAS
MDE - Códigos de Retorno TEF
MDG - Configurador TEF
SAE - Administração Financeira
SL4 - Condição Negociada
SLG - Estações
IMPORTANTE: A tabela MDG deve obedecer o modo de compartilhamento da tabela SLG (Cadastro de estações).
<!-- 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>
|