Visão Geral

O MK Solutions possui integração com o Cielo 3.0, o que viabiliza realização de pagamentos via cartão de crédito (e-commerce) no sistema. 

Com está integração será possível: 

• Receber pagamentos dos clientes do provedor via cartão de crédito;

• Cadastrar perfil de cartão de crédito (Profile de Pagamento);

• Configurar regras para o perfil de cartão de crédito; 

• Acompanhar as transações:

  • Com sucesso;

  • Com erro;

  • Que estão programadas para os próximos dias; 

  • Que estão programadas para os próximos dias que estão com alguma crítica;

• Verificar os cartões de créditos cadastrados e também cadastrá-los para os clientes; 

• Ativar e desativar cartões de crédito;

• Proporcionar ao cliente cadastrar seu cartão de crédito e definir sobre o débito automático nos ambiente de atendimento ao cliente (SAC WEB e SAC Plus);

• Executar rotina de captura de valores programados em massa; 

• Capturar valores programados de forma manual;

• Adicionar/Remover cobrança adicional de Cartão de crédito nas faturas de forma manual e automática;

• Transferir programações de fatura de um cartão para outro.

Configuração do Perfil de Cartão de Crédito (Profile de Pagamento)

Configuração para o uso do pagamento via cartão de crédito

1º Passo: Aderir ao Cielo 

• O provedor deve realizar o cadastro junto ao Cielo através deste link: Cadastro de novo cliente;

• O cadastro deve ser feito para uma solução Webservice do e-commerce;

• Após o cadastro, a Cielo mandará algumas informações por e-mail e o relacionamento da integração seguirá por esse meio;

• Há dois tipos de testes:

  • O Interno feito com tokens gerados pelo próprio provedor através do link Cadastro Sandbox (Tokens de Homologação);

  • E o teste feito junto à Cielo com tokens fornecido pela própria Cielo (Tokens de produção com tempo para expiração);

• Os tokens são os seguintes:

  • Merchant ID;

  • Merchant Key;

• Estes tokens devem ser registrados no sistema como explicado nos próximos passos;

• No e-mail, além do token de produção, a Cielo enviará um Formulário solicitando algumas informações 

2º Passo: Gerar Token para Homologação de Pagamentos com a Cielo 

Para gerar os tokens de homologação acesse Cadastro Sandbox.

O usuário terá que informar: 

• Nome;

• E-mail;

• Telefone; 

e marcar o checkbox 'Não sou um robô' e clicar no botão 'Cadastrar' 

O Merchant ID e Merchant Key serão exibidos em tela. Eles serão utilizados no próximo passo da configuração.

3º Passo : Cadastrar Tokens no sistema (Configurar Perfil de Cartão de Crédito)

O cadastro deverá ser registrado na seguinte tela:

ACESSO: Configuração → Menu Financeiro → Submenu Profile de Pagamento → Submenu Perfil Cartão de Crédito 

O usuário deverá informar : 

• Código: Código auto-numerável atribuído pelo banco de dados (Bloqueado para edição)

• Padrão: Definir se esse Perfil será o padrão do sistema SIM/NÃO

• Status da profile pode ser:

  • Homologação 

    • Esta definição deve ser feita para que o provedor faça seus testes internos (Como os tokens de homologação);

  • Produção 

    • Para quando a integração estiver em produção de fato (Com os tokens de produção efetivo); ou 

    • Para quando a Cielo estiver homologando para validar a integração para seguir para produção (Com tokens de produção com prazo de expiração)

• Habilitar para teste 

  • Sim - Para quando estiver realizando testes internos (com tokens de homologação)

    • Quando SIM o SAC WEB e APP permitirá apenas o cliente configurado para homologação realizar cadastro de cartões e liquidações

  • Não - Para quando estiver em produção de fato (Com os tokens de produção efetivo) ou para quando a Cielo estiver realizando as homologações (Com tokens de produção com prazo de expiração)

• Entidade - informe a operadora de cartão 

  • Cielo

• Loja Número: Informar o numero do token (Merchant ID) de acordo com o cenário desejada (Homologação/Produção para teste Cielo / Produção Efetivo)

• Loja Chave: Informar o numero de chave (Merchant Key) de acordo com o cenário desejada (Homologação/Produção para teste Cielo / Produção Efetivo)

• Cliente Homologação: Cliente que tem autorização para realizar cadastros de cartões e realizar liquidações em modo de homologação no SAC WEB e SAC Plus

• Desativada? Estando desativada ela não vai aceitar novas cobranças e nem efetuar novas capturas de valores.

Após este registro, deve-se preparar o ambiente para realizar os testes para validação.

4º Passo : Preparar Ambiente para Cielo realizar Homologação 

• Deve ser cadastrado um usuário para a Cielo acessar o SAC para realizar a homologação;

• Este usuário deve estar cadastrado no perfil do cartão (Profile de Pagamento);

• Deve ser criada uma conta para que o usuário da Cielo faça os teste de pagamento no SAC Web;

• Deve ser criada uma conta em um cenário que ao ser liquidada faça o desbloqueio de uma conexão;

• O mk deve estar configurado para permitir pagamento via cartão, sendo assim acesse Configuração →  Menu SAC →  Submenu Configuração SAC →  Marque a opção Permitir pagamentos (Saiba mais Pagamento via E-commerce (Cartão de Crédito));

  Open

  

• O provedor deverá passar as informações de Acesso ao SAC pra a Cielo; 

• A Cielo, para realizar a homologação, poderá solicitar algumas informações por e-mail;

• Após a aprovação, a Cielo irá enviar os Tokens de produção. 
  
  

Configuração da Regra de Recorrência do Perfil de Cartão de Crédito

ACESSO: Módulo Financeiro → Menu Transações Via Cartão → botão da Engrenagem Configurações de Recorrência

Open

Apenas uma Profile de Recorrência poderá ser definida como a ativa para receber as programações de recorrência 

Nesta configuração o usuário deverá informar:

• Profile de recorrência ativa - Informe a profile que está ativa no momento para a obtenção de novos cartões.

• Regra Ativa - Informe se a regra de pagamentos com cartão está ativa no momento. 

• Recorrência Ativa - Define se o fluxo de recorrência vai rodar automaticamente ou não. Isso não impede do processo ser chamado manualmente.

• Horário de execução da rotina de recorrência - Define o horário em que o fluxo da recorrência vai efetuar os pagamentos agendados (autorizados pelo cliente). 

• Atribuir fatura? SIM/NÃO - Definir se deverá ser atribuído automaticamente a ordem de recorrência para faturas já existentes.

  • Se definido como SIM, quando o cliente cadastrar um novo cartão pelo SAC WEB ou SAC Plus e defini-lo como Débito Automático, o sistema irá adicionar na faturas existentes uma cobrança adicional de cartão de crédito.

  • Se definido como NÃO, quando o cliente cadastrar um novo cartão pelo SAC WEB ou SAC Plus e defini-lo como Débito Automático, o sistema NÃO irá adicionar na faturas existentes uma cobrança adicional de cartão de crédito. 

    • Apenas irá adicionar na novas faturas que serão criadas para o contrato

• Alterar Profile? SIM/NÃO - Definir se deverá alterar automaticamente a profile de cobrança dos contratos deste cliente assim que ativo o débito automático. 

  • Se definido como SIM, quando o cliente cadastrar um novo cartão pelo SAC WEB ou SAC Plus e defini-lo como Débito Automático ou habilitar esta função para um cartão já cadastrado, o sistema irá:

    1. Trocar a profile dos contratos do cliente, para a profile de cartão de crédito de recorrência ativa.

       • No histórico do contrato teremos o registro da troca de profile do contrato na ativação do crédito automático do cartão 
         

    2. Trocar a conta default de configuração financeira do cliente

       • Definir a forma de pagamento como Cartão de Crédito 

       • Definir a profile de pagamento com a profile de recorrência ativa 

         Open

         

Gerenciar Cartões e Transações via cartão de crédito no Painel do Cliente

No Painel Cliente o operador poderá acompanhar as transações via cartão de crédito que estão programadas para o cliente, bem como cadastrar novos cartões e realizar alteração em suas configurações. 

ACESSO: Módulo Financeiro → Menu Painel do Cliente → Localize o cliente no painel e clique duas vezes sobre ele. 

Através dos seguintes painéis será possível realizar o gerenciamento das transações de cartão de crédito: 

Painel Faturas que estão programadas para transação via cartão de crédito

Neste painel o operador poderá visualizar todas as transações via cartão de crédito que estão programadas para o cliente em questão, ou seja, todas as faturas que: 

• Possuem uma cobrança do tipo Cartão associada ativa;

• Que não estão liquidadas, excluídas ou suspensas;

Open

Para cada transação teremos as seguintes informações, por padrão, disponibilizadas ao visualizar o painel: 

• Código identificativo da programação 

• Fatura: código da fatura

• Adicional: Se o cartão é uma cobrança adicional na fatura - SIM/NÃO

• Vencimento da fatura

• Descrição da fatura 

• Bandeira do cartão associado à fatura  

• R$ fatura 

• R$ saldo

• Número do cartão - número do cartão que está sendo utilizado

• Ativo: se o cartão associado à fatura está ativo - SIM/NÃO

• Dias de atraso do vencimento da fatura

DICA

• Fiquem atentos às colunas disponibilizadas para o painel, algumas podem estar ocultas, por padrão.

Open

Saiba mais sobre a visualização de colunas em Visualização de Dados na Grade/Tela 

• Ao clicar duas vezes sobre a transação no painel é possível visualizar o histórico da fatura

Neste painel o operador terá disponível as seguintes ferramentas:

Remover cobrança adicional das faturas

O operador poderá remover a programação do pagamento via cartão de crédito em débito automático através da remoção da cobrança adicional de cartão de crédito associado à fatura. 

Selecione uma ou mais faturas no painel e clique no botão "Remover cobrança adicional das faturas"

Open

Será aberta uma tela com o resultado da analise das faturas selecionadas. Para casa fatura teremos as seguintes informações:   

• Fatura: é o número do código da fatura;

• Vencimento:  data de vencimento da fatura;

• OK (SIM NÃO) - Se a fatura está OK para realizar a remoção da cobrança adicional;

• Descrição do resultado da análise;

  • Algumas Faturas não terão autorização para a remoção da cobrança adicional, o sistema irá exibir as seguintes descrições nas faturas não autorizadas:

    •  A fatura já está liquidada;

    •  A fatura está com status de excluída;

    •  A fatura está com o status de suspenso;

    •  A cobrança desta fatura não é adicional;

  • Caso a fatura esteja vencida a remoção da cobrança adicional será autorizada, o operador irá ser notificação desta situação;

    •  ATENÇÃO: Processo autorizado para fatura já vencida;

  • Quando a fatura não possuir criticas estará autorizada para o procedimento;

    •   OK - processo autorizado para a fatura;

No campo "Descreva o motivo pelo qual deseja executar este processo", use para escrever com detalhes os motivos de executar o procedimento.

Marque o check 'Tem certeza que deseja remover a cobrança adicional das cobranças disponíveis?' para dar ciência ao procedimento e clique no botão para executar o procedimento.

Pronto! a remoção da cobrança adicional foi realizada para as faturas que não apresentaram críticas e a partir desse momento estas não estarão mais programadas para transação via cartão de crédito.  

No histórico da fatura na aba das cobranças, a cobrança adicional de cartão de crédito está marcada como excluída. 

Open

Um evento também será registrado no histórico da fatura 

Open

Capturar valor de faturas selecionadas

O operador poderá realizar a captura do pagamento das faturas programadas para crédito automático de forma manual, basta selecionar uma ou mais faturas no painel e clicar no botão "Capturar valor de faturas selecionadas"

Open

Será aberta uma tela com o resultado da analise das faturas selecionadas. Para cada fatura teremos as seguintes informações:   

• Fatura: é o número do código da fatura;

• Saldo do valor a ser pago;

• OK (SIM/NÃO) - Se a fatura está OK para realizar a liquidação

• Descrição do resultado da análise 

  • Algumas Faturas não terão autorização para serem liquidadas, o sistema irá exibir as seguintes descrições nas faturas não autorizadas:

    •  A fatura já está liquidada. 

    •  A fatura está com status de excluída

    •  A fatura está com o status de suspenso

    •  A fatura está com liquidação parcial

  • O sistema irá realizar o reajuste dos valores da fatura de acordo com as regras de desconto e acréscimo da conta do cliente, o operador será notificado 

    •  Valor reajustado para X ref. a descontos de antecipação

    •  Valor reajustado para X ref. a acréscimos por atraso de Y dias

  • Quando a fatura não possuir criticas estará autorizada para o procedimento

    •  OK - processo autorizado para a fatura sem necessidade de reajuste.

Marque o check "Tem certeza que capturar os valores aptos?" para dar ciência ao procedimento e clique no botão para executar o procedimento.

Pronto! as faturas que não apresentaram críticas foram liquidadas pelo cartão associado. 

Um evento será registrado no histórico da fatura 

Open

Transferir as programações para outro perfil do cliente

O operador poderá trocar o cartão de crédito associado à fatura, basta selecionar uma ou mais faturas no painel e clicar no botão "Clique para transferir as programações selecionadas para outro perfil do cliente."

Open

Será aberta uma tela com o resultado da analise das faturas selecionadas. Para cada fatura teremos as seguintes informações:   

Nos campos abaixo da listagem de faturas

• Selecione a Profile de Cobranças (Serão listadas como opção apenas as profiles de cartão de crédito)

• Selecione o perfil do cliente (Serão listados apenas os cartões de crédito ativos do cliente e que estão associados à profile de cobrança selecionada)

Marque o check "Tem certeza que deseja transferir as cobranças disponível ao novo perfil selecionado?" para dar ciência ao procedimento e clique no botão 'Finalizar'

Um evento será registrado no histórico da fatura 

Open

Cartões de crédito salvos deste cliente

Neste painel o operador poderá visualizar todos os cartões de créditos cadastrados do cliente em questão 

Open

Para cada cartão de crédito teremos as seguintes informações: 

• Código identificativo do cadastro do cartão no sistema 

• Data do cadastro 

• Portador - Nome informado no cartão de crédito 

• Número do cartão 

• Crédito Auto SIM/NÃO - Se o cartão está habilitado para débito automático 

• Ativo SIM/NÃO -  se o cartão associado à fatura está ativo

DICA

• Fiquem atentos às colunas disponibilizadas para o painel, algumas podem estar por padrão ocultas.

Open

Saiba mais sobre a visualização de colunas em Visualização de Dados na Grade/Tela 

• Ao clicar duas vezes sobre o cartão será possível verificar o histórico de eventos sobre o cartão

Neste painel o operador terá disponível as seguintes ferramentas:

Inserir um novo cartão vinculado ao cliente

O operador poderá cadastrar o cartão para o cliente clicando no botão "Inserir novo cartão"

Open

Para o cadastro do cartão o operador deverá informar, conforme orientações dos campos à baixo: 

• Código - Código auto-numerável atribuído pelo banco de dados (Bloqueado para edição)

• Data/Hora - Data e hora de cadastro (Bloqueado para edição)

• Operador cadastro - Operador responsável pelo cadastro (Bloqueado para edição)

• Profile de pagamentos - Profile de pagamentos associada ao perfil de recorrência padrão (Bloqueado para edição)

• Ativo (SIM/NÃO) - Cartão está ativo?

• Crédito Auto - Indica se o cartão pode ser usado para gerar crédito automático

• Cliente - Cliente associado ao cartão

• Portador - Nome de identificação do portador do cartão

• Número do cartão - Número identificativo do cartão

• CVV - Código de segurança

• Mês - Mês de validade do cartão

• Ano  - Ano de validade do cartão

Marque o check "Confirma seu interesse em cadastrar este novo cartão para o cliente?" para dar ciência ao procedimento e clique no botão de efetivar o cadastro.

Pronto! O cartão do cliente foi cadastrado.

Em algumas situações não será possível realizar o cadastro do cartão de crédito, o sistema irá exibir as seguintes mensagens nesta situações:

•  ERRO! Foi impossível obter o token válido deste cartão

• ERRO! Não foi possível localizar nenhuma profile com configuração válida ativa

• ERRO! Não foi possível obter a bandeira do cartão informado

• ERRO! O cartão informado já está cadastrado para este cliente

Editar o perfil (cartão)