Operações com Cartão de Crédito / Débito (E-commerce)

Objetivo da rotina

Tem como objetivos disponibilizar ao "Pagador" uma forma de efetuar uma transação em formulário via web, de forma não presencial, onde este imputará todas as informações relativas ao Cartão de Crédito / Débito, inclusive Código de Segurança. Já para o recebedor tem como objetivo fornecer o gerenciamento sobre as transações de pagamento, sendo possível: gerar relatórios sobre os recebimentos, cancelar transações e verificar todo o histórico de cada transação.

Principais conceitos

Gateway de pagamento: É um serviço destinado a lojas virtuais, SaaS e empresas de grande porte. É mantida por uma operadora financeira que autoriza pagamentos de transações feitas online em websites de empresas ou pessoas físicas.

Requisitos

Inicialmente o Cliente que desejar utilizar o E-Commerce (ou também chamado de modelo não presencial) deverá entrar em contato com a CIELO, Safe2Pay ou VoallePay. Finalizando estes processos estará apto a utilizar as operações com cartão de crédito e débito no ERPVoalle.

Ações

Processo Utilização do Gateway

1. Acesse a Rotina Suíte / Configurações / Parâmetros no menu Financeiro.
2. Selecione no campo "Utiliza Gateway de Pagamento" a opção "Sim" (este campo por padrão virá marcado como "Não").
3. Salvando esse processo com o valor Sim"' será preciso sair do sistema e logar-se novamente, ao fazer isso, estará disponível o menu "Gateways de Pagamento", sendo que neste mesmo processo ainda será disponibilizado na rotina Financeiro / Operações / Dashboard - Operacional um menu com o nome de "Títulos - Transações com Cartões". Obs.: Este processo é de responsabilidade da Equipe da Voalle.

Configurar Gateways de Pagamento

1. Com o "Gateways de Pagamento" configurado no processo anterior, será possível configurar este "Gateway de Pagamento" visualizado na rotina Suíte / Configurações / Parâmetros menu "Gateways de Pagamento", onde atualmente está disponível o Gateway da CIELO, Safe2Pay e VoallePay com suas respectivas configurações, as quais devem ser parametrizadas com a Equipe da Voalle.
2. Configure os campos de acordo com cada integradora, conforme descritas a seguir:

CIELO

Configurações

Ativo: Defina se Gateway selecionado estará ativo ou não.
Antifraude Ativo: Defina se o Gateway deve fazer a verificação antifraude ou não.
Autenticação Débito: Defina se para transações de débito será necessário o cliente autenticar-se.
Taxa por Transação: Defina se será cobrado taxa pela transação, neste primeiro momento só estará disponível a opção "Sim".
URL de Retorno: Defina para onde o usuário será direcionado após realizar o Pagamento tipo Débito e autenticar-se. Deve ser preenchido com: http:// www."ENDERECO_DO_PORTAL.COM" /facilita/bankOrder/. Obs.: O preenchimento deste campo é obrigatório.
Armazenamento: Defina o local onde será armazenado os arquivos referentes as transações. Obs.: Para preenchimento deste campo deve ser contactado o time Voalle. O preenchimento deste campo é obrigatório.

Homologação

Servidor Consulta: Defina a URL do servidor de consulta que será utilizado em homologação. Deve ser preenchido com: https://apiquerysandbox.cieloecommerce.cielo.com.br Obs.: O preenchimento deste campo é obrigatório.
URL API: Defina a URL da API de consulta que será utilizado em homologação. Deve ser preenchido com: https://apisandbox.cieloecommerce.cielo.com.br Obs.: O preenchimento deste campo é obrigatório.
URL Token: Defina a URL do Token que será utilizado em homologação. Deve ser preenchido com:

https://mpisandbox.braspag.com.br Obs.: O preenchimento deste campo é obrigatório.

Produção

Servidor Consulta: Defina a URL do servidor de consulta que será utilizado em produção. Deve ser preenchido com: https://apiquery.cieloecommerce.cielo.com.br/. Obs.: O preenchimento deste campo é obrigatório.
URL Produção: Defina a URL da API de consulta que será utilizado em produção. Deve ser preenchido com: https://api.cieloecommerce.cielo.com.br//. Obs.: O preenchimento deste campo é obrigatório.
URL Token: Defina a URL do Token que será utilizado em produção. Deve ser preenchido com:

https://mpi.braspag.com.br Obs.: O preenchimento deste campo é obrigatório.

Autenticação 3DS 2.0

Habilitar autenticação?: Identifica se as transações por cartão de débito irão utilizar o modelo de autenticação 3DS 2.0

Estabelecimento 3DS 2.0

Código: É o Código do Estabelecimento enviado ao provedor pela Cielo. É usado para fazer a consulta do token.
MCC: Merchant Category Code é o código de categoria do estabelecimento, informado pela Cielo ao provedor.
ClientKey e ClientSecret: Estes são dados que a Cielo envia para o provedor. Essas informações são usadas pela Voalle pra gerar uma hash pra consultar o token na realização da autenticação 3DS.

ATENÇÃO: essas informações DEVEM SER OBTIDAS pelo cliente diretamente COM A CIELO.

Configurações por Local

Novo Local: Clique em Novo Local, a seguir preencha os seguintes campos:
Local: Escolha os Locais da empresa, de acordo com os CNPJ cadastrados.
Cód. Loja: Deve ser informado pelo cliente.
Chave: Deve ser informada pelo cliente.

3. Clique em Confirmar.

SAFE2PAY

Configurações

Ativo: Defina se Gateway selecionado estará ativo ou não.
Autenticação Débito: Defina se para transações de débito será necessário o cliente autenticar-se.
URL de Retorno: Defina para onde o usuário será direcionado após realizar o Pagamento tipo Débito e autenticar-se. Obs.: O preenchimento deste campo é obrigatório.

Configurações por Local

Novo Local: Clique em Novo Local, a seguir preencha os seguintes campos:
Local: Escolha os Locais da empresa, de acordo com os CNPJ cadastrados.
Token: Chave utilizada pelo ERP com o Gateway. Deve ser informada pelo cliente.
Secret Key: Chave utilizada pelo Gateway. Deve ser informada pelo cliente.

3. Clique em Confirmar.

VOALLEPAY

Configurações

Ativo: Defina se Gateway selecionado estará ativo ou não.
Autenticação Débito: Defina se para transações de débito será necessário o cliente autenticar-se.
URL de Retorno: Defina para onde o usuário será direcionado após realizar o Pagamento tipo Débito e autenticar-se. Obs.: O preenchimento deste campo é obrigatório.

Configurações por Local

Novo Local: Clique em Novo Local, a seguir preencha os seguintes campos:
Local: Escolha os Locais da empresa, de acordo com os CNPJ cadastrados.
Token: Chave utilizada pelo ERP com o Gateway. Deve ser informada pelo cliente.
Secret Key: Chave utilizada pelo Gateway. Deve ser informada pelo cliente.

3. Clique em Confirmar.

Utilizando E-commerce no Totem

Para o utilizar esta funcionalidade o Totem precisa ser configurado, quando cadastrado um novo terminal de autoatendimento você deverá habilitar o parâmetro em Suíte/ Financeiro/ Gateway de Pagamento.

Cadastro de tipo de cobrança para E-Commerce / TEF

Primeiramente deverá ser realizado os cadastros de Tipos de Cobranças que serão utilizados, esta Rotina pode ser realizada no seguinte caminho: Financeiro / Cadastros / Tipos de Cobrança. Acessando está Rotina, será adicionado um novo Tipo de Cobrança, onde os seguintes campos devem ser preenchidos: Tipo (este tipo deve ser obrigatoriamente "999 - Cartão"), Título e Conta, após salvar este processo, será habilitado mais alguns campos para preenchimento, entre eles o campo "Habilitar no Portal", o qual irá definir se o Tipo de Cobrança estará disponível para E-Commerce (então terá que selecionar o "SIM") ou para a TEF (terá que selecionar "NÃO"). Este processo é de responsabilidade da Equipe da Voalle.

* Os tipos de cobranças são vinculados ao Local através do campo "Conta". Estes conceitos podem ser visualizados na tabela abaixo:

Detalhes
Campo	Conceito
Tipo	Tratando-se de cartão de crédito e/ou débito este tipo deve ser obrigatoriamente "999 - Cartão".
Título	Deve-se ser preenchido com o nome do tipo de cobrança. *Preenchimento Obrigatório.
Conta	Deve ser preenchido com a conta vinculada ao tipo de cobrança, esta conta definirá para qual Local o tipo de cobrança está vinculada. Após a conciliação o sistema irá transferir os valores referente a ao que foi conciliado da conta definida no campo Conta Mov. Cartão do menu Config. Cartão para esta conta . Em caso de dúvidas, referentes ao cadastro de conta verificar a Rotina: Financeiro / Cadastros / Contas. Só serão listadas contas que em seu cadastro o campo "Tipo" esteja definido como Banco* *Preenchimento Obrigatório.
Status	Este definirá se o tipo de cobrança estará "Ativo" ou "Inativo".

Config. Cartão
Campo	Conceito
Forma Pagamento	Este campo definirá a "Forma de pagamento" que irá ser utilizada para o tipo de cobrança ("Cartão Débito" ou "Cartão Crédito"). *Preenchimento Obrigatório.
Bandeira	Neste campo deve ser definido a bandeira utilizada no tipo de cobrança, estas bandeiras podem ser: Visa, Master Card, American Express (Amex), Elo, Diners Club, Discover, JCB, Aura ou Hipercard. *Preenchimento Obrigatório.
Gateway	Neste campo deve ser definido o Gateway do tipo de cobrança. Os valores disponíveis serão os Gateways configurados no sistema. *Preenchimento Obrigatório.
Cancelamento	Neste campo é possível escolher um prazo para cancelamento do pagamento, tem-se duas opções, sendo elas: "Até o final do dia" ou "Até X dias após a transação". *Preenchimento Obrigatório.
Dias Cancelamento	Este campo só será habilitado se o cancelamento do pagamento for selecionado como "Até X dias após a transação". Deve ser definido o número de dia para o cancelamento. * De acordo com a CIELO o cancelamento via requisição sistêmica (API) pode ser executado em até 300 dias da realização da operação á crédito. Para Débito o cancelamento é permitido também em até 300 dias. *Preenchimento Obrigatório.
Receber Após	Representa a quantidade de dias para a efetivação da transação do pagamento. Por Exemplo: Caso este campo esteja definido com número 2 e a data de vencimento da fatura for dia 28 a data de vencimento será atualizada para o dia 30. * Durante o processamento da transação a ADQUIRENTE irá fornecer uma previsão de pagamento, com esta previsão possivelmente a data de previsão definida pelo valor deste campo será alterada para o valor da previsão fornecido pela ADQUIRENTE. * Para Débito a CIELO recomenda 3 dias e para crédito 30 dias. *Preenchimento Obrigatório.
Habilitar no Portal	Define se o tipo de cobrança vai estar disponível no Portal ou no Facilita ("Sim" ou "Não"). *Preenchimento Obrigatório.
Nat. Fin Taxa	Está natureza Financeira irá representar os valores de taxa sobre as transações que utilizarem este tipo de cobrança após conciliação. *Preenchimento Obrigatório.
Nat. Fin. Conciliação	Está natureza financeira irá representar os valores das transações que utilizarem este tipo de cobrança após conciliação. Só serão listadas naturezas financeiras em que o campo "Tipo" esteja definido como Analítica* e o campo "Sinal" definido como Transitório. *Preenchimento Obrigatório.
Conta Mov. Cartão	Este campo define a conta que será usada para representar os valores financeiros que estão sobre responsabilidade do gateway de pagamento (ainda não foi realizada conciliação). Só serão listadas contas que em seu cadastro o campo "Tipo" esteja definido como CAIXA* e o campo "Caixa Atendimento" esteja definido como NÃO. *Preenchimento Obrigatório.
Pagador	Deverá ser preenchido com o responsável pelo pagamento. Por Exemplo: No caso da CIELO deverá ser criada uma pessoa para o mesmo e informado neste campo. *Preenchimento Obrigatório.
Cond. Pagamento	Este campo só será habilitado se for pressionado o botão "Nova Taxa", caso a "Forma Pagamento" selecionada seja "Cartão Crédito", será possível definir várias condições de pagamentos. Por exemplo: A Prazo 2X, A Prazo 10 X. * Para "Forma de pagamento" "Cartão Débito" o sistema considera como padrão o modelo de pagamento à vista. * Todas as bandeiras disponíveis se tratando do modelo presencial devem ter as mesmas opções de condições de pagamento cadastradas. *Preenchimento Obrigatório.
Tipo Taxa	Este campo só será habilitado se a for pressionado o botão "Nova Taxa". O tipo de taxa pode ser escolhido entre "Percentual" ou "Valor Fixo". *Preenchimento Obrigatório.
Taxa	Este campo só será habilitado se a for pressionado o botão "Nova Taxa". Esta Taxa irá apresentar o valor correspondente ao que foi selecionado no campo "Tipo Taxa", ou seja, se o "Tipo Taxa" for "Percentual" será cobrado um percentual do valor transacionado. Caso seja "Valor Fixo" será cobrado o valor definido no campo taxa. *Preenchimento Obrigatório.

* Não será possível cadastrar tipos de cobrança que tenham valores iguais nos campos: Forma de Pagamento, Bandeira, Gateway, Conta (vinculado ao Local).

Módulos(s)

Esta funcionalidade está disponível para acesso no Módulo Financeiro e no Portal de Atendimento.

Rotina(s)

Dashboard Operacional do Módulo Financeiro, pelo menus: Títulos - Recebimentos Cartão de Crédito e Lançamento Caixa/Bancos

Outras Rotinas envolvidas serão:

Financeiro / Relatórios / CRE - Títulos Recebidos

Financeiro / Análises / CRE - Recebimentos

Financeiro / Análises / Nat Fin Evolução

Financeiro / Análises / Nat Fin - Comparativo

Financeiro / Operações / Dashboard - Arquivos Magnéticos.

Financeiro / Operações / Manut. Registro Contábil.

Financeiro / Utilitários / CRE - Exclusão Recebimentos

Financeiro / Operações / Operações com cartão

Documentações Relacionadas

Natureza Financeira da Evolução

Natureza Financeira Comparativo

Manutenção Registro Contabíl

Dashboard de arquivos magnéticos

CRE Títulos Recebidos

CRE Exclusão Recebimentos

Operações com Cartão Funcionamento

Totem

Objetivo

Também conhecida como e-commerce este modelo de pagamento não presencial, tem como objetivo disponibilizar ao "Pagador" uma forma de efetuar uma transação em formulário via web, onde este imputará todas as informações relativas ao Cartão de Crédito / Débito, inclusive Código de Segurança.

Funcionamento

O pagamento não presencial pode ser realizado de duas formas, sendo elas:

- Portal de Relacionamento: Ao acessar o portal o usuário deverá acessar o menu "Utilidades" e clicar no botão "Segunda via Boleto", assim o sistema irá apresentar uma listagem com todas as faturas que possuírem as seguintes informações: nosso número, movimentação bancária, não tenham sido recebidas e que sejam boletos, dessa forma possibilitará ao usuário "Pagar"ou "Imprimir" os mesmos. Ao selecionar a opção de "Pagar", o usuário será direcionado para uma página onde irá conter todas as informações que deverão ser preenchidas para efetuar o pagamento, estas informações serão: "Tipo de Cartão" (poderá optar por Débito ou Crédito), "Bandeiras Aceitas" (exibidas de acordo com o Tipo de Cartão selecionado), "Número do Cartão", "Vencimento", "Nome no Cartão", "Cód. de Segurança", "E-mail do Titular" e "Opções de Pagamento" (estas opções serão apresentadas de acordo com o que foi cadastrado no Tipo de Cobrança para a Bandeira do cartão). Após os campos serem preenchidos o próximo passo será selecionar "Confirmar Pagamento", assim o sistema irá apresentar uma mensagem se a transação foi realizada com sucesso ou não.

* Ao pagar uma fatura que esteja em atraso, a mesma terá seus valores atualizados conforme juro e multa (regras definidas no ERP Voalle).

* Se o "Tipo de Cartão" selecionado for Débito ao "Confirmar Pagamento" o usuário será direcionado para confirmar a autenticação do pagamento ou não, se optar por não autenticar, o mesmo não acontecerá e consequentemente a fatura permanecerá em aberto.

* O Retorno do arquivo da CIELO será processado automaticamente pelo ERP Voalle para os pagamentos com Cartões Débito e Crédito, não sendo preciso processar o arquivo de retorno pela Rotina: Financeiro / Operações / Dashboard - Integração Bancária.

- Facilita: Ao acessar o Facilita com seu respectivo CPF ou CNPJ, o usuário irá ser direcionado para uma listagem com todas as faturas que possuírem as seguintes informações: nosso número, movimentação bancária, não tenham sido recebidas e que sejam boletos, dessa forma possibilitará ao usuário "Pagar" ou "Imprimir" os mesmos, as funcionalidades seguintes acontecerão da mesma forma que acontece no Portal de Relacionamento.

* Na listagem quando a fatura for selecionada, o sistema já estará apresentando o valor da fatura atualizada, levando em consideração juros e multas que poderão estar agregadas a este valor.

- Históricos das Transações: Todas as transações com cartões realizadas pelo Portal de Relacionamento e/ou pelo Facilita, ficarão registradas na Rotina: Financeiro / Operações / Dashboard - Operacional menu Títulos - Transações com Cartões, nesta tela o usuário terá acesso a todo o histórico de transações realizadas, além disso o mesmo poderá cancelar estas transações, conciliar e/ou imprimir um relatório das mesmas. O processo de conciliação consiste em sinalizar o recebimento de uma fatura, manualmente não esperando o arquivo de retorno ser processado (conciliação automática) selecionando uma transação que esteja aguardando pagamento e pressionando o botão conciliar o usuário então deve informar a data em que foi realizado o pagamento. Ainda nesta tela, é possível ter as seguintes informações sobre uma determinada Fatura: Cliente (identificação do cliente), N° Fatura / Gateway (identificação da fatura e do Gateway), Cód. Autorização / NSU (identificação do código de pagamento e do NSU gerado no momento de pagamento), Rcbto. Cliente (data em em o cliente realizou o pagamento), Prev. Pgto (data fornecida pelo Gateway ), Rcbto. Gateway (data em que foi identificado o recebimento do Gatewary), Taxa (taxa definida no tipo de cobrança), Valor (valor a ser pago), Situação (situação deste pagamento).

* Ao clicar sobre o N° Fatura / Gateway será exibida uma janela contendo todas as informações e eventos ocorridos com a determinada Fatura, ou seja, um histórico sobre todas as eventualidades ocorridas com a Fatura selecionada em ordem cronológica dos acontecimentos.

* Se o usuário optar por cancelar o recebimento de uma fatura, o mesmo irá ser eliminado da listagem (mesmo "Aguardando Pagamento" ou estando "Pago", neste último caso o recebimento será estornado), então será necessário gerar o nosso número para a Fatura ficar disponível novamente para o pagamento ser realizado. Para gerar o Nosso número o link da documentação relacionada é o seguinte: Integração Bancaria

* O cancelamento de recebimento de uma fatura também pode ser realizado por outra Rotina, está localiza-se em Financeiro / Utilitários / CRE - Exclusão Recebimentos, sendo que a documentação relacionada sobre este processo pode ser acessada pelo link: CRE Exclusão Recebimentos

* O cancelamento de recebimento de uma fatura só não é permitido caso a mesma já esteja em um arquivo contábil gerado.

* Este menu de "Títulos - Transações com Cartões", por padrão, só estará disponível para usuários que possuírem suas "Permissões de Acesso" definidas para a "Dashboard Operacional". Ao selecionar as "Permissões de Acesso" na "Dashboard Operacional" o usuário poderá se deparar com duas situações:

Situação 1) Se nenhum menu estiver selecionado nas "Permissões de Acesso" este usuário terá acesso à todas as funcionalidades da "Dashboard Operacional";

Situação 2) Se o usuário possuir no mínimo um menu selecionado nas "Permissões de Acesso", o mesmo só irá visualizar da "Dashboard Operacional", o que lhe for permitido.

* Todo o controle contábil, e movimentação bancaria poderá ser acompanhado pelas rotinas: Financeiro / Análises / Nat Fin Evolução Financeiro / Análises / Nat Fin - Comparativo, Financeiro / Operações / Dashboard - Arquivos Magnéticos, Financeiro / Operações / Manut. Registro Contábil e em especial pela Dashboard Operacional do Módulo Financeiro, pelo menus: Títulos - Recebimentos Cartão de Crédito e Lançamento Caixa/Bancos, onde o usuário poderá acompanhar quanto já foi recebido pelo mesmo, para as transações com cartões, assim como, comparar com quanto ainda tem a receber e o que será descontado (taxas) na conta Conta Mov. Cartão.

* Pelas rotinas: Financeiro / Relatórios / CRE - Títulos Recebidos e Financeiro / Análises / CRE - Recebimentos o usuário poderá extrair relatórios filtrando quais pagamentos foram realizados de maneira presencial e não presencial.

Caso durante a leitura do arquivo de transações o sistema não encontre a fatura que consta no arquivo ou que a mesma não apareça como paga, o sistema irá abrir um protocolo para a Voalle verificar automaticamente este problema. Caso no ERP Voalle o cliente possua um responsável financeiro definido (Rotina: Suíte / Configurações / Parâmetros; Campo: Resp. Financeiro), o mesmo receberá um e-mail avisando a abertura deste protocolo, caso não haja nenhum responsável financeiro definido o sistema vai enviar este e-mail para os usuários administradores. O mesmo vai ocorrer no caso da Cielo não disponibilizar arquivos de retorno para o dia de "hoje", neste caso a mensagem tanto no e-mail quanto no protocolo será: "A Cielo não disponibilizou o(s) arquivo(s) para o dia de hoje ou houve falha no processo de download dos arquivos."

No caso de divergências de valores de taxa sobre a transação e valor total da fatura, o sistema enviará um e-mail para o responsável financeiro definido informando tal divergências, como por exemplo:

Exemplo 1 : Taxa não correspondente com a especificada nas configurações. Verifique o título/fatura de id X e número FAT.

Exemplo 2 : O valor do Título/Fatura não corresponde com o valor pago. Título/Fatura de id X e número FAT.

- Terminal de Autoatendimento (Totem): Ao acessar o Totem o usuário deverá informar seu CPF ou CNPJ, posteriormente pressionar o botão avançar onde o mesmo deve selecionar qual fatura deseja pagar, então o mesmo deve pressionar o botão E-Commerce então mesmo deve informar os dados do seu cartão de crédito para pagamento. Após a realização do pagamento, o Totem irá imprimir um comprovante de Pagamento.

Inicialmente sistema está integrado com a operadora CIELO, sendo possível posteriormente a integração com outras operadoras.
O uso de cartões de crédito ou débito está disponível momentaneamente apenas para a operação recebimento, seu uso para operações de venda será disponibilizado posteriormente.
De acordo com a contratação do Cliente junto às Instituições Financeiras/Operadora, após as parametrizações necessárias para o uso de cartões de crédito e débito no ERP Voalle serão feitas pela equipe Voalle.
O prazo para cancelamento das transações depende do fornecedor.
As bandeiras que a versão atual do Webservice CIELO suporta são as seguintes: Visa, Master Card, American Express, Elo, Diners Club, Discover, JCB, Aura e Hipercard, sendo que, cada uma destas atendem algumas particularidades em relação a Crédito à Vista, Crédito Parcelado Loja, Débito, Voucher e Internacional, mais detalhes podem ser obtidos no Link: https://developercielo.github.io/manual/cielo-ecommerce.
Os títulos que foram pagos parcialmente não serão listados no Portal de Atendimento e no Facilita.
Para os clientes em que o contrato se encontrar na situação de bloqueio financeiro, após efetuarem os pagamentos dos títulos pendentes, terão seu contrato normalizado e consequentemente voltarão a utilizar o serviço contratados normalmente. Caso a transação deste pagamento seja cancelada o sistema irá bloquear o contrato novamente, ao processar o Cron de bloqueio.
O parcelamento de um pagamento desenvolvido nesta solução contempla o modelo Parcelamento Loja: Para o estabelecimento o pagamento é realizado mensalmente parcela a parcela no prazo acordado, descontada a taxa negociada.
Para a natureza financeira da conciliação deve ser utilizada naturezas que em seu cadastro o campo "Tipo" esteja definido como Analítica e o campo "Sinal" definido como Transitório.
Para a Conta Mov. Cartão deve ser utilizada só contas que em seu cadastro o campo "Tipo" esteja definido como CAIXA e o campo "Caixa Atendimento" esteja definido como NÃO.