| ||||||
| ||||||
|
|
||||||||||
| Home | Soluções | Downloads | Suporte | Comprar | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  O Aprova Fácil é uma solução de automatização de vendas com cartão de crédito que utiliza como meio de captura a Internet. O Aprova Fácil é utilizado em situações de venda onde não há presença "física" do cartão de crédito. Clique nas imagens abaixo e veja seu funcionamento em cada situação de venda:
|
 |
|
|
|||||||||||||||||||
|
|
|
|||||||||||||||||||
 |
|
|
|||||||||||||||||||
|
Para visualizar maiores informações sobre o Aprova Fácil, clique aqui. Para visualizar informações sobre o funcionamento do Aprova Fácil, clique aqui. |
|
1. Instalação Plataforma Unix
A instalação deverá ser realizada em Servidores Web Unix - Linux, Solaris, FreeBSD e BSDI. Procedimento:
Versão CGI Arquivo CGIAprovaFacilEste arquivo deverá ser instalado em um diretório do seu servidor que tenha permissão para "rodar" aplicativos do tipo CGI (verifique com seu provedor).
Verifique a lista de permissões a serem passadas em ambiente Unix. Veja a correspondência: Considere: R - Ler W - Escrever X - Executar
Arquivo CGIAprovaFacil.iniInstale-o no mesmo diretório onde está localizado o arquivo CGIAprovaFacil. Este é um arquivo de parâmetros de configuração e deverá ser editado conforme instruções existentes no item 4 - Edição do CGIAprovaFacil.ini (abaixo). Diretório LicencaEm seu download original esta pasta contém uma licença para realização de testes denominada cartaoteste.conf. Posteriormente, este arquivo de teste deverá ser substituído pela "licença definitiva", que será disponibilizada pela Cobre Bem ao ser contratado o Aprova Fácil.
2. Instalação Plataforma Windows
A instalação deverá ser realizada em Servidores Web Windows. Procedimento:
Versão CGI Arquivo CGIAprovaFacilEste arquivo deverá ser instalado no diretório do seu servidor que tenha permissão para ''rodar'' aplicativos executáveis. Verifique a lista de permissões a serem passadas em ambiente Windows. Veja a correspondência: Considere: R - Ler W - Escrever X - Executar
Arquivo CGIAprovaFacil.iniInstale-o no mesmo diretório onde está localizado o arquivo CGIAprovaFacil.exe. Este é um arquivo de parâmetros de configuração e deverá ser editado conforme instruções existentes no item 4 - Edição do CGIAprovaFacil.ini (abaixo). Diretório LicencaEm seu download original esta pasta contém uma licença para realização de testes - cartaoteste.conf. Posteriormente este arquivo de teste deverá ser substituído pela licença definitiva disponibilizada pela Cobre Bem Tecnologia ao ser contratado o Aprova Fácil.
Versão CobreBemX (componente COM)Solução da Cobre Bem criada para integrar aplicações desenvolvidas em diversas linguagens e diversos meios de pagamento, tais como: Boleto Bancário, Débito Automático e Cartão de Crédito. Você poderá utilizar o CobreBemX para integrar o Aprova Fácil ao seu aplicativo desenvolvido em Delphi, Access, VBNet etc. Para instalar o CobreBemX em seu servidor, siga o procedimento abaixo:
Disponibilizamos no site da Cobre Bem um exemplo prático em ASP que trata os valores passados conforme o que cada tecnologia de conectividade determina. O exemplo desse script contém uma lista das propriedades obrigatórias para que seja realizada uma transação. Procedimento de chamada deste script:O script será chamado duas vezes, a primeira vez será chamado por um outro script do seu site, que estará passando os valores para as variáveis.
Na segunda vez será chamado pelo servidor da Cobre Bem, que passará os valores para os parâmetros: - NUMPEDIDO - caso seja Komerci (Redecard); - TID - caso seja Verified By Visa (Visanet). Clique aqui para visualizar os passos para a instação no Windows Server 2003.3. Orientações para Configuração Servidor DNS
As orientações apresentadas a seguir, são válidas para as plataformas Windows e Unix, para as versões CGI e CobreBemX (plataforma Windows). Teste para verificar a Configuração do Servidor DNS:
4. Edição do CGIAprovaFacil.ini
O arquivo CGIAprovaFacil.ini é composto de 06 (seis) parâmetros:- ArquivoLicenca; - ModoOperacao; - URLResultadoAprovado; - URLResultadoNegado. - ServidorProxy; - PortaProxy; Parâmetro ArquivoLicencaInforme neste parâmetro o caminho físico absoluto do Arquivo de Licença que será utilizado. Ressaltamos que não é URL. Exemplo: /CaminhoDoCgi-BinNoSeuServidor/Licenca/cartaoteste.conf Parâmetro ModoOperacaoEste parâmetro é subdividido em três fases: Demonstração, Simulação e Produção. Sendo que o modo Simulação somente pode ser utilizado na conectividade TEF Dedicado. Informe no parâmetro ModoOperacao, o Código correspondente a fase em que o seu estabelecimento se encontra, respeitando o que cada tecnologia de conectividade exige, veja abaixo: 0= Demostração 1= Simulação 2= Produção Modo DemonstraçãoPermite o conhecimento das funcionalidades do Serviço Aprova Fácil no seu próprio ambiente. - O modo Demonstração é utilizado somente na tecnologia TEF Dedicado. Modo SimulaçãoPermite o conhecimento das funcionalidades do Serviço Aprova Fácil entre seu próprio ambiente e o ambiente da Cobre Bem Tecnologia. - O modo Simulação é utilizado somente na tecnologia TEF Dedicado. Modo ProduçãoAo informar no arquivo CGIAprovaFacil.ini, o parâmetro ModoOperacao=2, sua estrutura estará automaticamente em Modo de Produção, permitindo que sejam realizados testes iniciais em produção, tais como, a comunicação entre a sua estrutura e o servidor do Aprova Fácil. Posteriormente serão realizados testes de automatização da transação, diretamente com a Administradora. - As conectividades do tipo Verified By Visa e/ou MoSet da Visanet e Komerci da Redecard, somente poderão ser utilizadas em modo de Produção. - Se o estabelecimento possuir habilitação junto às Administradoras nas conectividades citadas acima, o status a ser informado obrigatoriamente é o número 2 (Produção); Para realizar testes no Aprova Fácil é necessário que o estabelecimento seja habilitado junto às Administradoras em uma das seguintes tecnologias: TEFDedicado / Verified By Visa / MoSet / Komerci / Komerci Webservice. Parâmetro URLResultadoAprovadoInforme neste parâmetro a Página Web ou o Script que será chamado, caso o resultado da transação seja "Aprovado" (True). Note que este Script será utilizado em situações como: Salvar resultado na Base de Dados, Envio de Resultados para o endereço de E-mail do Cliente etc. Parâmetro URLResultadoNegadoInforme neste parâmetro a Página Web ou o Script que será chamado, se o resultado da transação for "Negado" (False). Note que este Script será utilizado em situações como: Salvar resultado na Base de Dados, Envio de Resultados para E-Mail do Cliente etc. Servidores com ProxyAo utilizar o Servidor com Proxy, informe o parâmetro ServidorProxy, preenchendo o IP do Servidor Proxy ou nome do Servidor e o parâmetro PortaProxy, informando a porta que será utilizada pelo Proxy. Geralmente é utilizada a porta 8080. 5. Integração com seu aplicativo
Em nosso site, disponibilizamos como exemplo duas lojas virtuais open-source muito utilizadas na internet com o módulo de exemplo do Aprova Fácil, são elas: osCommerceÉ uma loja virtual de fonte aberta, que possui catálogo e ferramenta de administração, facilitando assim, a instalação e o gerenciamento das vendas, podendo ser utilizada em várias línguas, tais como: Inglês, Alemão e Espanhol. A loja osCommerce foi desenvolvida por www.oscommerce.org, e a comunidade PHPmania, disponibiliza uma versão em português desta loja.
VirtuaStore OpenÉ um sistema de e-commerce open-source (gratuito) escrito em ASP que tem como finalidade criar um aplicativo que seja fácil de instalar e usar. Escrita totalmente em português a VirtuaStore Open foi desenvolvida pela comunidade Yahoo que tem como finalidade facilitar o processo de instalação da loja. Para efetuar o download do módulo do Aprova Fácil com as lojas citadas acima, acesse Downloads Lojas. CobreBemX (componente COM)Você poderá integrar o sistema Aprova Fácil a um aplicativo seu, seja ele off line ou on line utilizando o componente CobreBemX. Ressaltamos que somente poderá ser utilizado o CobreBemX em servidores Web Windows. Para instalar o CobreBemX em seu servidor, verifique o Item 2 - Instalação Plataforma Windows / Sub-Item - Versão CobreBemX (Componente COM). Para instalar na máquina, veja abaixo:
Disponibilizamos exemplos dessa utilização em diversas linguagens que ilustram como passar as propriedades que chamam o Aprova Fácil, veja os exemplos a partir de: Downloads. 6. Executando o Aprova Fácil
O Aprova Fácil pode ser integrado em lojas virtuais ou mesmo a partir de um simples Formulário de Pedido em HTML.Neste "Formulário de Pedido" serão digitados os dados do cartão do cliente no momento da compra. A Cobre Bem Tecnologia disponibiliza um Formulário de Pedidos de Teste que contém todos os parâmetros para utilização do Aprova Fácil. Para visualizar o referido formulário, acesse a URL CGI que está em seu servidor.
Para verificar os parâmetros a serem informados, acesse o link pertinente ao seu tipo de venda e verifique seu tipo de conectividade nas tabelas que seguem. Comércio Eletrônico Venda Agendada Venda RecorrenteÉ necessário a utilização de um certificado SSL no "Formulário de Pedido", pois no ato da compra serão trafegados dados sensíveis dos clientes, através de uma conexão de rede pública como a Internet. Esta é uma exigência das Administradoras de Cartão de Crédito para homologação da sua loja. Recomendamos que seja utilizada uma Chave SSL de 128bits. Exceto se seu estabelecimento estiver habilitado para Tecnologia de Conectividade Verified By Visa da Visanet, pois neste caso o cliente digita os dados do cartão em ambiente seguro disponibilizado pela Visanet. 7. Arquivo de Licença Definitivo
O Arquivo de Licença contém os dados de sua loja, ou seja, contém os dados que identificam seu estabelecimento junto ao sistema Aprova Fácil.Para que seu estabelecimento funcione em produção, este arquivo deverá ser gerado afim de substituir o arquivo de licença de teste que que acompanha o download original do Aprova Fácil. O arquivo de licença deve ser gerado na área do Extrato, fornecida quando o serviço Aprova Fácil for assinado. Clicando na imagem abaixo, você visualiza como gerá-lo.
8. Conectividades/Tecnologias
A conectividade é determinada de acordo com o tipo de venda/negócio que seu estabelecimento irá desempenhar.Para habilitar o estabelecimento em uma das tecnologias de conectividade disponibilizadas pelas Administradoras, entre em contato com as mesmas e "revele" ao acessor comercial todo processo de venda a ser realizado pela sua loja. Conforme descrevemos anteriormente, cada tecnologia atende a um tipo de necessidade, logo, cada uma delas possuem características distintas para que sejam utilizadas. Particularidades das Conectividades TEF Dedicado Komerci Verified By Visa9. Captura da Transação
A Captura da transação é um processo entre a confirmação da transação e o débito efetivo do cartão do cliente, no Aprova Fácil pode ocorrer de duas formas: Manual e/ou Automatica.As tecnologias Komerci e Komerci Webservice da Redecard não permitem confirmação/captura do tipo manual, sendo possível somente a do tipo automática, com prazos de captura de 2 e 5 minutos, respectivamente. Porém, caso o estabelecimento esteja habilitado para Komerci e Komerci Webservice com "Pré-Autorização", então, a captura poderá ser realizada de forma manual com prazo de 5 dias corridos a partir da data do processamento realizado pela Administradora de Cartão de Crédito. ManualO lojista adota o modo de captura Manual, caso deseje realizar uma verificação do pedido antes de confirmar a transação junto à Administradora. A URL de acesso ao extrato é fornecida quando o serviço Aprova Fácil é contratado. Ao ser verificado através da Página de Extrato que a transação foi aprovada, o lojista clica no botão "Confirmar". Ao confirmar a transação junto à Administradora será realizado efetivamente o débito no cartão do cliente. O prazo para que ocorra a confirmação da transação através do Extrato é de 48 horas a partir da data de processamento, porém através das Administradoras o tempo de confirmação varia. Verifique os prazos através da tabela apresentada a seguir:
AutomáticaAo ser aprovada uma transação junto à Administradora, através da ação de um script é confirmado automaticamente o débito no cartão do cliente. A confirmação automática é realizada através de comandos inseridos dentro de um script. Disponibilizamos com a funcionalidade da "captura automática", o exemplo de um script em PHP. Na confirmação automática, o Action do Form deverá receber a URL do CGI mais o parâmetro /CAP. Exemplo: http://www.seusite.com.br/cgi-bin/CGIAprovaFacil.exe/CAP Para que a transação seja confirmada automaticamente, informe o parâmetro obrigatório Transacao, correspondente ao item Número da Transação, tendo como possíveis valores a informação do número da última Transação. Informações Importantes:Na tecnologia de conectividade Komerci (Redecard) o prazo para confirmação da transação é de apenas 02 minutos, sendo assim, somente poderá ser utilizada a Confirmação Automática. Caso no processo de confirmação da transação, ocorra algum problema com a Redecard, a solicitação pode ser perdida. Neste caso, deverá ser feito novamente o pedido de confirmação no prazo estipulado pela Administradora - 2 minutos. O desenvolvedor, estando ciente desta situação, deverá montar uma programação em seu código, que solicite o reenvio do pedido de confirmação automaticamente, caso a primeira solicitação seja retornada com uma mensagem de erro. Todo este processo deverá ser realizado no tempo de 2 minutos que a Redecard disponibiliza para que seja realizada a confirmação da transação. Caso seja ultrapassado os 2 minutos, o cliente deverá refazer o pedido na loja. 10. Cancelando Transações
Ao ser efetuada uma transação e confirmada a venda, o lojista poderá efetuar o cancelamento da mesma através da URL de Extrato do Aprova Fácil, desde que a ação de cancelamento seja realizado no mesmo dia do seu processamento.Após este prazo, o cancelamento deverá ser feito através de contato realizado com a Administradora que processou a transação via telefone ou site. 11. Administração de Transações
Estará disponível para utilização da Empresa/Estabelecimento um Extrato, contendo todas as solicitações encaminhadas para o Aprova Fácil.Através deste extrato será possível também realizar um acompanhamento das automatizações realizadas dia a dia e os seus respectivos status informados pelas Administradoras de Cartão de Crédito. O acesso aos dados das solicitações será efetuado pela Empresa/Estabelecimento, através da Internet a partir de uma URL protegida por certificado SSL e somente acessada por usuário e senha que serão enviados para o endereço de e-mail do responsável pelo gerenciamento do serviço, este designado pela própria empresa. Clique nas imagens abaixo para visualizar as páginas do Extrato.
Ressaltamos que para efetuar o login na área exclusiva - Extrato do Aprova Fácil, o usuário responsável pelo estabelecimento deverá digitar o usuário e senha, informados pela Cobre Bem Tecnologia. Estes são compostos de letras maiúsculas e minúsculas (case sensitive) e que devem ser respeitados e mantido em sigilo, trazendo assim, maior segurança ao acesso do mesmo. Note que se no processo de implantação do Aprova Fácil o lojista necessitar repassar essa senha para seu desenvolvedor, poderá fazê-lo. Posteriormente, quando a loja estiver em produção, o lojista poderá solicitar à Cobre Bem uma nova senha de acesso ao Extrato do Aprova Fácil. Ao definir o critério desejado será exibido no máximo 200 ocorrências, sendo assim, é aconselhável que na definição do critério seja informado também a data e o horário a ser consultado . Através da URL de Retorno, o desenvolvedor terá acesso a informações gerenciais que poderão ser gravadas em seu aplicativo de gestão (ERP) conforme sua necessidade. Quando ao acessar a URL de Extrato - https://www.cobrebem.com/apf - for exibida a mensagem - Ocorreu um erro 401 no servidor - possivelmente não foi informado o usuário e senha corretamente no momento de acesso à página de Extrato. 12. Dúvidas Freqüentes
Para isso acesse a URL a seguir Dúvidas Freqüentes.Ressaltamos que nosso suporte é concedido apenas à nossa solução, o Aprova Fácil. Para obter suporte das lojas virtuais disponibilizadas em nosso site, acesse a URL da respectiva comunidade, informada no item 5 deste manual. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Copyright © 2007 Cobre Bem Tecnologia - Todos os direitos reservados. |
|
