Exibir código-fonte para Recorrência com Cartão de Crédito

== Configuração ==
Recorrência com Cartão de Crédito

=== Objetivo da documentação ===
Explicar como realizar a configuração para utilizar a recorrência com cartão de crédito.  A recorrência tem por objetivo realizar a gestão do pagamento periodicamente sem comprometer o limite do cliente. 

== 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.<br>

'''Recorrência no cartão:''' Recorrência é uma cobrança recorrente; uma opção de transação em que o débito é feito automaticamente no cartão de crédito do cliente, não comprometendo seu limite. <br>

''Token:'' Dispositivo eletrônico gerador de senhas, geralmente sem conexão física com o computador. Em algumas versões, consegue conexão através de uma porta USB. <br>

== Passo a passo ==

{{Icone|tipo=cliente}} '''Se você deseja utilizar um Gateway de Pagamento em seu ERPVoalle, abra um protocolo para a Assessoria ao Cliente da Voalle solicitando a parametrização e as demais configurações.'''

=== Parametrização dos Gateways de Pagamento no ERPVoalle ===
{{Icone|tipo=voalle}} <br>

'''Obs:''' Esta parametrização é de responsabilidade da equipe da Voalle. <br>

'''1.''' Acesse a rotina ''Suíte / Configurações / Parâmetros'', menu '''Financeiro'''. <br>

'''2.''' Na seção ''Gateway de Pagamento'', no campo '''Utiliza Gateway de Pagamento''', selecione a opção SIM. <br>

'''3.''' Salve as alterações, saia do sistema e faça seu login novamente. <br> 

'''4.''' Agora, acesse novamente a rotina ''Suíte / Configurações / Parâmetros'', menu '''Financeiro'''. Será disponível o menu ''''Gateways de Pagamento''''. Além disso, será disponibilizado o menu de [[Títulos - Transações com Cartões]] na rotina ''Financeiro / Operações / Dashboard - Operacional''. <br>

=== Como configurar os Gateways de Pagamento ===

'''1.''' Acesse a rotina ''Suíte / Configurações / Parâmetros'', menu ''Gateways de Pagamento''. <br>

'''2.''' Selecione uma das opções de Gateway disponíveis na listagem ou clique em "Adicionar" para adicionar um novo. 

'''3.''' Ajuste com as respectivas configurações.

'''Obs:''' A recorrência de cartão de crédito pode ser utilizada com os seguintes Gateways: '''Safe2Pay''' e  '''Cielo'''.

==== Cielo ====

CONFIGURAÇÕES <br>

* Em ''Ativo'', defina se o Gateway deve ficar ativo. <br>

* Em ''Antifraude Ativo'', defina se o Gateway deve fazer a verificação antifraude. <br>

* Na ''Autenticação Débito'', defina se será necessária a autenticação do cliente. <br>
'''Obs:''' Para o Gateway da '''Cielo''', deve ser marcada a opção '''Sim'''. Para outras operadoras, consulte a configuração necessária. <br>

* Em ''Taxa por Transação'', defina se será cobrada uma taxa pela transação. Neste primeiro momento, só estará disponível a opção '''Sim'''. <br>

* Em ''URL de Retorno'', defina para onde o usuário será direcionado após realizar o Pagamento tipo Débito e autenticar o login.
'''Obs:''' Exemplo de endereço - '''https:// www."ENDERECO_DO_PORTAL.COM" /facilita/bankOrder/'''. <br>
Também, verifique se o endereço é HTTPS OU HTTP. <br>

* Em ''Armazenamento'', defina o Local onde serão armazenados os arquivos referentes às transações. <br>
'''Obs:''' Contate a equipe de Infraestrutura da Voalle para preencher esse campo. <br>


HOMOLOGAÇÃO <br>

* Em ''Servidor Consulta'', defina a URL do servidor de consulta que será utilizada em homologação. <br>
'''Obs:''' Exemplo de URL - '''https://apiquerysandbox.cieloecommerce.cielo.com.br''' <br>

* Em ''URL API'', defina a URL da API de consulta que será utilizada em homologação. <br>
'''Obs:''' Exemplo - '''https://apisandbox.cieloecommerce.cielo.com.br''' <br>


PRODUÇÃO <br>

* Em ''Servidor Consulta'', defina a URL do servidor de consulta que será utilizado em produção. <br>
'''Obs:''' Exemplo - '''https://apiquery.cieloecommerce.cielo.com.br/''' <br>

* Em ''URL Produção'', defina a URL da API de consulta que será utilizada em produção.
'''Obs:''' Exemplo - '''https://api.cieloecommerce.cielo.com.br//''' <br>


CONFIGURAÇÕES POR LOCAL <br>

* No botão '''+ Novo Local''', você adiciona os Locais da empresa, sendo que, para cada Local, deve ser informado o '''Código da Loja''' e a '''Chave'''.
Os valores do Código da Loja ('''Cód. Loja''') e a '''Chave''' devem ser informados pelo cliente. <br>

==== Safe2Pay ====

CONFIGURAÇÕES <br>

* Em ''Ativo'', defina se o Gateway selecionado estará ativo ou não. <br>

* Em ''Autenticação Débito'', defina se para as transações de débito será necessária a autenticação do cliente. <br>
'''Obs:''' Para o Gateway da '''Cielo''', deve ser marcada a opção '''Sim'''. Para outras operadoras, consulte a configuração necessária. <br>

* Em ''URL de Retorno'', defina para onde o usuário será direcionado após realizar o Pagamento tipo Débito e autenticar o login. <br>
'''Obs:''' Exemplo - '''https://www."ENDERECO_DO_PORTAL.COM" /facilita/bankOrder/''' <br>
Também, verifique se o endereço é HTTPS OU HTTP. <br>

CONFIGURAÇÕES POR LOCAL <br>

* No botão '''+Novo Local''', você consegue adicionar os Locais da empresa, sendo que, para cada Local, deve ser informado o '''Local''', o '''Token''' e a '''Secret Key'''.
'''Obs:''' Os valores do '''Token''' e da '''Secret Key''' são obtidos através do cadastro do local na própria Safe2Pay: '''https://safe2pay.com.br/login?redirect=%2F'''. <br>

==== VoallePay ====
Para saber informações referentes à configuração do VoallePay, clique [[Voalle Pay|aqui]].

=== Como configurar o cadastro de Locais ===

'''1.''' Acesse a rotina ''Suíte / Cadastros / Locais'' e selecione, na listagem, o Local que você deseja configurar. <br>

'''2.''' Vá ao menu '''Parâmetros''', tópico '''Parâmetros Globais - Venda'''. <br>

'''3.''' No campo '''Tipo de Cobrança''', adicione tipos correspondentes ao '''cartão de crédito'''. <br>

=== Como aderir à modalidade da recorrência com cartão de crédito ===
==== Adesão de um cliente já existente ====
'''1.''' Acesse a rotina ''Service Desk / Operações / Dashboard - Contratos'', menu '''Contratos - Manutenção'''. <br>

'''2.''' Selecione um contrato da listagem. <br>

'''3.''' Acesse o menu '''Utilitários''' e selecione a opção '''Configurar Recorrência (Cartão)'''.

'''4.''' Ao lado direito, selecione um ''Tipo de Cobrança''. <br>

'''5.''' Em ''Cartão'', insira os dados do cartão do cliente após clicar no ícone de adição. Informe a ''Bandeira'', o ''Número do Cartão'', o ''Nome do Cartão'', a data de ''Vencimento'' (mês/ano) e o ''Cód. de Segurança''. <br>

'''6.''' Ao clicar no botão CONFIRMAR, o ERPVoalle adiciona um token no cartão do cliente. Ou seja, para realizar a transação de recorrência, não é necessário informar novamente os dados do cartão do cliente, e sim o token gerado junto ao Gateway. Com isso, o ERP não precisa guardar informações do cartão do cliente no banco de dados da aplicação. O sucesso na geração do token será informado em uma mensagem na tela e, em caso de falha, você é sinalizado - aqui, é necessário fazer os ajustes para que o token do cartão para o Gateway seja gerado. <br>

A recorrência pode ser cadastrada pelo próprio cliente via Portal de relacionamento. Para isso o cliente deve acessar o  Portal > Utilitários > Mensalidade no Cartão, clicar no ícone ''Cadastrar ou alterar a recorrência''{{Icone|tipo=Credit-card}} e preencher seu dados. 

Para cadastramento via app [[Menu Recorrência|clique aqui]] e veja o passo a passo.

'''Obs:''' Serão gerados eventos no contrato para monitorar o processo.

==== Adesão de um novo cliente ====
'''1.''' Após o processo de venda, acesse a rotina ''CRM / Operações / Dashboard - Vendedor'', menu '''Clientes em Ativação'''. <br>

'''2.''' Selecione o cliente e clique no ícone "Configurar Recorrência" {{Icone|tipo=Credit-card}}. <br>

'''3.''' Na janela "Configurar Recorrência", selecione o ''Tipo de Cobrança'' e inclua o ''Cartão'' do cliente.Informe a ''Bandeira'', o ''Número do Cartão'', o ''Nome do Cartão'', a data de ''Vencimento'' (mês/ano) e o ''Cód. de Segurança''. <br>

'''4.''' Clique em CONFIRMAR. <br>

==== Como cancelar a Recorrência ====
'''1.''' Acesse a rotina ''Service Desk / Operações / Dashboard - Contratos'', menu '''Contratos - Manutenção'''. <br>

'''2.''' Selecione um contrato na listagem. <br>

'''3.''' Acesse o menu '''Utilitários''' e selecione a  opção '''Cancelar Recorrência (Cartão)'''. 

'''4.''' Selecione um novo ''Tipo de Cobrança'' (que será diferente de Cartão) e informe uma ''Justificativa''. <br>

'''5.''' Salve as alterações.

A recorrência pode ser cancelada pelo próprio cliente via Portal de relacionamento. Para isso o cliente deve acessar o  Portal > Utilitários > Mensalidade no Cartão, clicar no ícone '' Cancelar a recorrência''{{Icone|tipo=cancelar_atendimento}}.

Ao fazer o cancelamento da recorrência o sistema irá atribuir o tipo de cobrança configurado na rotina de [[Locais|Suíte / Cadastros / Locais > Parâmetros > Parâmetros - Recorrência com Cartão]]

==== Como alterar o cartão da Recorrência ====
'''1.''' Para alterar o cartão vinculado ao cliente e continuar com a Recorrência com cartão, acesse a rotina ''Service Desk / Operações / Dashboard - Contratos'', menu '''Contratos - Manutenção'''. <br>

'''2.''' Selecione um contrato na listagem e acesse o menu '''Utilitários'''. <br>

'''3.''' Agora, selecione a opção '''Alterar Recorrência (Cartão)'''. 

'''4.''' Selecione o ''Tipo de Cobrança'' respectivo à bandeira do novo cartão.

'''5.''' Informe o novo ''Cartão'' e apresente uma ''Justificativa''. Feito isso, o ERPVoalle gera um novo token para o cartão.

A recorrência pode ser alterada pelo próprio cliente via Portal de relacionamento. Para isso o cliente deve acessar o  Portal > Utilitários > Mensalidade no Cartão, clicar no ícone ''Cadastrar ou alterar a recorrência''{{Icone|tipo=Credit-card}} e preencher seu dados. 

'''Obs:''' Serão gerados eventos no contrato para monitorar o processo.

=== Como acompanhar ===
Após realizar o faturamento mensal de um contrato, são gerados os documentos fiscais e a fatura para cobrança. A partir disso, as faturas vinculadas aos contratos que possuem recorrência com cartão de crédito são disponibilizadas na [[Dashboard - Recorrência]].

== Páginas relacionadas ==
[[Operações com Cartão de Crédito / Débito (E-commerce)]]

[[Operações com Cartão#Funcionamento|Operações com Cartão Funcionamento]]

[[Recorrência de Cartões: Códigos de Retorno]]

== Perguntas frequentes ==
[[Recorrência no cartão: Qual o pré-requisito para poder realizar a Recorrência?]]

[[Recorrência no cartão: Onde posso cadastrar a Recorrência?]]

[[Recorrência no cartão: Como faço para  utilizar a Recorrência?]]

[[Recorrência no cartão: Posso cadastrar mais de um cartão para a Recorrência? Se sim, o título será debitado de qual cartão?]]

[[Recorrência no cartão: Como faço para cancelar a Recorrência de um cartão?]]

[[Recorrência no cartão: O título pode não aparecer no portal mesmo com a recorrência cadastrada?]]

[[Recorrência no cartão: Caso o cliente esteja com bloqueio, ele poderá incluir um cartão para recorrência? ]]

[[Recorrência no cartão: Como o ERP trata o cadastramento de recorrência em um contrato com o faturamento do tipo cobrança Antecipada?]]