Cobre Bem Tecnologia
INSTITUCIONAL
Empresa especializada em soluções padronizadas de meios de pagamento e de recebimento. Há 15 anos, a Cobre Bem Tecnologia é líder nacional no mercado de softwares de cobrança.
Atualmente, destaca-se no âmbito internacional por seus diferenciais.
SEGURANÇA COMPROVADA
A Cobre Bem Tecnologia é o primeiro Provedor de Serviços de Pagamento (PSP) brasileiro a conquistar a certificação de total conformidade com as normas do PCI.
CERTIFICAÇÃO CIELO (EX-VISANET)
No Brasil, apenas duas empresas especializadas em automatização de vendas com cartão de crédito na Internet possuem certificação.
EVENTOS
1, 2 e 3 de setembro - Venha comemorar conosco o aniversário da Cobre Bem no Congresso C4. Inscrições gratuitas: www.congressoc4.com.br
FALE CONOSCO
Informações comerciais ou técnicas sobre nossas soluções:
(11) 4063 7719 São Paulo
(21) 4063 9367 Rio de Janeiro
(31) 4062 7987 Minas Gerais
suporte@cobrebem.com
comercial@cobrebem.com
Descrição
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 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.
Instalação Plataforma Unix
A instalação deverá ser realizada em Servidores Web Unix - Linux, Solaris, FreeBSD e BSDI.
Procedimento:
- Efetue o download da versão CGI para Linux, a partir da Área de Downloads;
- Arquivos que compõem o download Leia-me e CGI-BIN, veja:
- Efetue o upload do arquivos CGIAprovaFacil, CGIAprovaFacil.ini e cartaoteste.conf para seu servidor web;
- Altere as permissões do arquivo CGIAprovaFacil para 755 (rwxr-xr-x);
- Edite o arquivo CGIAprovaFacil.ini conforme a tecnologia de conectividade que seu estabelecimento está habilitado, e altere o caminho do arquivo de licença na primeira linha do arquivo de forma a refletir a localização física deste arquivo em seu servidor Web.
Ressaltamos que o caminho a ser colocado não é URL; - Para verificar se o arquivo está sendo chamado corretamente, abra seu navegador e "chame" a URL do CGI do seu site. Deverá ser exibida a página de teste contendo todos os parâmetros aceitos pelo programa.
Versão CGI
Arquivo CGIAprovaFacil
Este 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).
Observação: Normalmente o diretório designado para instalação de CGI's é denominado cgi-bin ou cgi-local.
Verifique a lista de permissões a serem passadas em ambiente Unix. Veja a correspondência: Considere: R - Ler W - Escrever X - Executar
| CGIAprovaFacil | |
|---|---|
| Permissão | Descrição |
| 755 | RWX, R-X, R-X |
Arquivo CGIAprovaFacil.ini
Instale-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 Licenca
Em 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.
Observação: Recomendamos que esta pasta seja instalada no mesmo diretório onde está instalado o CGIAprovaFacil.
Instalação Plataforma Windows
A instalação deverá ser realizada em Servidores Web Windows.
Procedimento:
- Efetue o download da versão CGI para Windows, a partir da Área de Downloads;
- Arquivos que compõem o download Leia-me e WWWROOT, veja:
- Efetue o upload do arquivos CGIAprovaFacil, CGIAprovaFacil.ini e cartaoteste.conf para seu servidor web;
- O diretório onde ficará instalado o arquivo CGIAprovaFacil.exe deverá possuir permissão para execução de aplicativos;
- Edite o arquivo CGIAprovaFacil.ini conforme a tecnologia de conectividade que o seu estabelecimento está habilitado, e altere o caminho do arquivo de licença na primeira linha do arquivo de forma a refletir a localização física deste arquivo em seu servidor Web.
Ressaltamos que o caminho a ser colocado não é URL; - Para verificar se o arquivo está sendo chamado corretamente, abra seu navegador e ''chame'' a URL do CGI do seu site. Deverá ser exibida a página de teste contendo todos os parâmetros aceitos pelo programa.
Versão CGI
Arquivo CGIAprovaFacil
Este 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
| Permissão | Descrição |
|---|---|
| 755 | RWX, R-X, R-X |
| 775 | RWX, RWX, R-X |
Arquivo CGIAprovaFacil.ini
Instale-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 Licenca
Em 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.
Observação: Recomendamos que esta pasta seja instalada no mesmo diretório onde está instalado o CGIAprovaFacil.exe.
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:
- Descompacte o arquivo de instalação em um diretório desejado;
- Instale o CobreBemX em seu servidor Windows;
- Execute o arquivo "Instalar.exe" para registrar a DDL no seu Servidor Windows.
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.
Nota: O exemplo em questão é apresentado com valores fixos.
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 (Cielo - Visanet).
Clique aqui para visualizar os passos para a instação no Windows Server 2003.
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:
- Abra um navegador no servidor e acesse a URL: http://www.aprovafacil.com;
- O resultado esperado é que seja exibido o site da Cobre Bem Tecnologia;
- Se o resultado exibido for diferente do resultado esperado (item 2) será necessário configurar o DNS;
- Se a estrutura utiliza Firewall, em alguns casos pode ser que a sua estrutura não esteja "enxergando" a estrutura do Aprova Fácil, sendo assim, conceda a abertura da Porta 80 (porta de saída);
- Caso o servidor esteja utilizando um servidor Proxy, e haja uma instalação do CobreBemX (plataforma Windows) será necessário alterar as seguintes propriedades no CobreBemX do objeto PadroesProxy:
- Caso o servidor esteja utilizando um servidor Proxy, e tendo uma instalação da versão CGI (plataformas Windows e Unix), será necessário completar os dois parâmetros a seguir:
ServidorProxy
Informe o nome do servidor ou endereço IP;
PortaProxy
Informe a porta que está sendo utilizada pelo Proxy. Normalmente a porta utilizada é 8080;
ServidorProxy
Informe o nome do servidor ou endereço IP;
PortaProxy
Informe a porta que está sendo utilizada pelo Proxy. Normalmente a porta utilizada é 8080.
Edição do CGIAprovaFacil.ini
O arquivo CGIAprovaFacil.ini é composto de 06 (seis) parâmetros:
- ArquivoLicenca;
- ModoOperacao;
- URLResultadoAprovado;
- URLResultadoNegado;
- ServidorProxy;
- PortaProxy.
Parâmetro ArquivoLicenca
Informe 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 ModoOperacao
Este 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ção
Permite 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ção
Permite 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ção
Ao 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 Cielo (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 URLResultadoAprovado
Informe 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 URLResultadoNegado
Informe 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 Proxy
Ao 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.
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.
Manual Integração OsCommerce
Clique aqui para realizar o download do Manual com procedimentos de configuração do Aprova Fácil em uma Loja osCommerce a partir do Módulo de Exemplo que a Cobre Bem disponibiliza.
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:
- Descompacte o arquivo de instalação em um diretório desejado;
- Execute o arquivo "Instalar.exe" para registrar a DLL no seu Windows.
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.
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.
Importante:
Os parâmetros necessários para realização da venda irão depender do tipo de conectividade e tipo de venda que o estabelecimento está habilitado junto à Administradora.
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.
É 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 Cielo (Visanet), pois neste caso o cliente digita os dados do cartão em ambiente seguro disponibilizado pela Cielo (Visanet).
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.
Procedimento:
- Efetue o download do arquivo a partir da Página de Extrato;
- Salve o novo arquivo gerado sobre o outro já existente.
Aviso Importante:
Por medida de segurança, o arquivo de configuração (.conf) possui prazo de expiração de 01 ano, sendo assim, recomendamos que seja atualizado a cada 06 meses. Caso este procedimento não seja efetuado, o arquivo irá expirar, como conseqüência disso, seu estabelecimento irá parar de realizar vendas.
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
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.
Manual
O 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:
| Prazos para realização da Captura Manual | ||
|---|---|---|
| Tecnologia | Página de Extrato | Administradoras |
| TEF Dedicado - Cielo (Visanet) | 48 horas | Não é possível capturar pela Administradora |
| TEF Dedicado - AMEX | 23 horas | Não é possível capturar pela Administradora |
| Verified By Visa | até 5 dias | até 5 dias |
| Komerci | Não é possível captura Manual | Prazo de 2 minutos |
| Komerci Web Service | Não é possível captura Manual | Prazo de 2 minutos |
Automática
Ao 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.
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.
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.aprovafacil.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.
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.
Índice
- Instalação Plataforma Unix
- Instalação Plataforma Windows
- Configuração Servidor DNS
- Edição do CGIAprovaFacil.ini
- Integração com seu Aplicativo
- Executando o Aprova Fácil
- Arquivo de Licença Definitivo
- Conectividades/Tecnologias
- Captura da Transação
- Cancelando Transações
- Administração de Transações
- Dúvidas Freqüentes