mozgbrasil / magento-redecard-php_54
Integração ao redecard
Installs: 30
Dependents: 1
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 1
Open Issues: 0
Type:magento-module
Requires
This package is auto-updated.
Last update: 2024-12-05 18:24:40 UTC
README
Mozg\Redecard
Sinopse
Integração a Redecard
Motivação
Atender o mercado de módulos para Magento oferecendo melhorias e um excelente suporte
Demonstração
Suporte / Dúvidas
Para obter o devido suporte Clique aqui, relatando o motivo da ocorrência o mais detalhado possível e anexe o print da tela para nosso entendimento
Preço
Recursos do módulo
- [✓] Transação
- [✓] Consulta
- [✓] Captura
- [✓] Reembolso
- [✓] Cancelamento
Característica técnica
No checkout é feito o processo de autorização
No retorno de "Transação autorizada" é feito redirecionamento para a página de sucesso
Na página de sucesso é enviado infomações para o recurso de notificação da transação
Via CRON deve ser processado a notificação da transação,
No processamento da notificação caso o pagamento seja confirmado, deve ser alterado o "state/status" do pedido para "processing" ou seja "Processando", liberando as ações para processar a fatura e o envio
Antes do envio da mercadoria, sempre confira as informações do pedido, se o status da transação está sendo exibido que o pagamento foi confirmado, inclusive junto a operadora financeira se a transação foi capturada, caso algo esteja inconsistente será necessário cancelar o pedido até a correção da ocorrência
Quando o pedido é enviado o status é alterado para "complete" ou seja "Completo"
Foi implementada automação para a cada 5 minutos ser feito a consulta do status da transação para ser atualizado o status do pedido
Setup Cron
Para o uso do método é necessário ativar a CRON para o Magento
Clique aqui para visualizar o documento da MOZG
Certifique-se de que ação esteja sendo executado a cada minuto
Esse módulo usa o cronjob para processar as notificações
O módulo executa as notificações que foram recebidas há pelo menos 5 minutos.
Testando na Heroku
Gostaria de apresentar o aplicativo que disponibilizei para a plataforma Heroku
Com apenas 1 clique, o aplicativo cria sua loja virtual usando a plataforma de comércio eletrônico Magento e instala os módulos da MOZG
https://github.com/mozgbrasil/heroku-magento#descrição
Instalação - Atualização - Desinstalação - Desativação
--
Sugiro "printar" as telas com todos os procedimentos executados
Envie para nós as imagens das telas na eventualidade de quaisquer dificuldades
--
Este módulo destina-se a ser instalado usando o Composer
Execute o seguinte comando no terminal, para visualizar a existencia do Composer e sua versão
composer --version
Caso não tenha o Composer em seu ambiente, sugiro ler o seguinte artigo Clique aqui
--
É necessário que o servidor tenha o suporte a extensão ionCube PHP Loader
Para visualizar a existência da extensão nesse ambiente denominado PHP CLI, execute o seguinte comando no terminal
php -v
Para visualizar se essa extensão está ativa em seu servidor no ambiente denominado PHP WEB
Certique se da presença do arquivo phpinfo.php na raiz do seu projeto
<?php phpinfo(); ?>
Caso não exista o arquivo phpinfo.php na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima
Acesse o arquivo pelo browser
Em seguida pesquise pelo termo "ionCube PHP Loader"
Caso o seu servidor não tenha o suporte a extensão, entre em contato com sua empresa de hospedagem e peça para que eles ativem a extensão
Caso tenha a permissão e queira ativar a extensão, Clique aqui
Em "Loader Downloads API", efetue download do pacote compatível com o seu servidor
Descompacte o pacote e faça upload do arquivo "loader-wizard.php" para seu servidor, onde será demonstrado o passo a passo para a ativação da extensão
Clique aqui para ver os processos executados
--
Na presença do "ionCube PHP Loader" efetue o download do seguinte arquivo e coloque na raiz do seu servidor e acesse, se funcionar quer dizer que o "ionCube" está lendo esse tipo de encriptação
--
Para utilizar o(s) módulo(s) da MOZG é necessário aceitar o Acordo de licença do usuário final
--
Sugiro manter um ambiente de testes para efeito de testes e somente após os devidos testes aplicar os devidos procedimento no ambiente de produção
--
Sugiro efetuar backup da plataforma Magento e do banco de dados
--
Antes de efetuar qualquer atualização no Magento sempre mantenha o Compiler e o Cache desativado
--
Certique se da presença do arquivo composer.json na raiz do seu projeto Magento e que o mesmo tenha os parâmetros semelhantes ao modelo JSON abaixo
{
"minimum-stability": "dev",
"prefer-stable": true,
"license": [
"proprietary"
],
"repositories": [
{
"type": "composer",
"url": "https://packages.firegento.com"
}
],
"extra": {
"magento-root-dir": "./",
"magento-deploystrategy": "copy",
"magento-force": true
}
}
Caso não exista o arquivo composer.json na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima
Para instalar o módulo execute o comando a seguir no terminal do seu servidor no diretório do seu projeto
composer require mozgbrasil/magento-redecard-php_54:dev-master
Você pode verificar se o módulo está instalado, indo ao backend em:
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
Para atualizar o módulo execute o comando a seguir no terminal do seu servidor no diretório do seu projeto
Antes de efetuar qualquer processo que envolva atualização no Magento é recomendado manter o Compiler e Cache desativado
composer update
Na ocorrência de erro, renomeie a pasta /vendor/mozgbrasil e execute novamente
Para checar a data do módulo execute o seguinte comando
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
Para desinstalar o módulo execute o comando a seguir no terminal do seu servidor no diretório do seu projeto
composer remove mozgbrasil/magento-redecard-php_54
--
Para desativar o módulo
-
Antes de efetuar qualquer processo que envolva atualização sobre o Magento é necessário manter o Compiler e Cache desativado
-
Caso queira desativar os módulos da MOZG renomeie a seguinte pasta app/code/local/Mozg
A desativação do módulo pode ser usado para detectar se determinada ocorrência tem relação com o módulo
Como configurar o método de pagamento
Para configurar o método de pagamento, acesse no backend em:
STORES -> Configuration -> Sales/Payment Methods -> Redecard (powered by MOZG)
Você terá os campos a seguir
Redecard - Configurações Padrão
Configurações necessárias
• Modo Teste ou Produção
Deve ser informado o devido ambiente
• Código de filiação Komerci
Informe o seu código de filiação
• Usuário Komerci
Informe o usuário de acesso a Redecard
• Senha Komerci
Informe a senha de acesso a Redecard
Os dados de usuário e senha é usado para o tipo de captura manual
Avançado: Processamento de Pedidos Magento
• Status do pedido: ordem de criação
Status dos pedidos recém-criados, antes da confirmação de resultado de pagamento via notificações de servidor da operadora
• Status do pedido: autorização de pagamento
Status dos pedidos após autorização confirmada por uma notificação de AUTORIZAÇÃO da operadora
• Status do pedido: pagamento confirmado
Status dos pedidos após captura confirmada por uma notificação de AUTORIZAÇÃO da operadora
• Status do pedido: cancelamento de pedido
Status dos pedidos após cancelamento confirmada por uma notificação de CANCELAMENTO da operadora
Se as encomendas já estiverem faturadas, não poderão ser canceladas
• Status do pedido: captura de pagamento (produtos virtuais)
Selecione somente o status atribuído ao estado concluído, deixe vazio para usar o mesmo que os produtos normais
• Status do pedido: Reembolsado
Status dos pedidos após reembolso confirmada por uma notificação de REEMBOLSO da operadora
• Status do pedido: Reembolsado Parcial
Status dos pedidos após reembolso (parcial) confirmada por uma notificação de REEMBOLSO_PARCIAL da operadora. Recomendamos que não defina este status e deixe Magento decidir o status.
• Status do pedido: pedidos pendentes
Status dos pedidos após notificação de PENDENCIA da operadora
• Tipo de Captura
A opção "automática" deve ser selecionado, na necessidade do uso dessa automação que deve ser executada no processamento da notificação que é executada via CRON
A opção "manual" deve ser selecionado, na necessidade de capturar a transação manualmente, essa ação é feita acessando a fatura do pedido e clicando no botão "Capturar"
• Criar uma fatura pendente (apenas para captura manual)
Isso criará uma fatura pendente se a notificação de AUTORIZAÇÃO for recebida.
Nota: isto fará com que Magento empurre todas as encomendas para o estado: 'Processamento' uma vez que a factura é criada, ignorando todas as outras definições.
• Status do pedido: Capturar no embarque
Se você habilitar esta função será feito uma solicitação de captura para a operadora se você fizer o envio
• Ativar Descancelar pedido
Se uma pedido é cancelada por algum motivo, mas recebeu uma notificação de que o pagamento é autorizado, isso cancelará automaticamente o pedido
• Cancelamento\Reembolso automático quando o pedido é cancelado
Ativar / Desativar reembolso automático ao cancelar um pedido
• E-mail da fatura
Ativar / desativar atualizações de e-mails
• Enviar e-mail de notificação do status do pedido
Ativar / desativar e-mails de atualização para todas as alterações no status do pedido para o cliente
• Ativar log de depuração
Deve ser armazenado os processos do módulo em var/log/
O arquivo
DATE_mozg.log
se trata de log do módulo sendo um log mais detalhado contendo todos os processos inclusive das execuções realizadas pelas bibliotecas externas do módulo
O arquivo
payment_METHOD.log
Avançado: Redecard Notificações
• Ignorar notificação de reembolso
Se o reembolso for feito na operadora, e a mesma enviar uma notificação de reembolso para o Magento, deve ser criado automaticamente uma nota de crédito. Se você definir essa configuração como 'Sim', isso não acontecerá porque ele não processará nenhuma das notificações de REEMBOLSO recebidas.
Avançado: Experiência de Checkout
• Redirecionar o destino após o cancelamento
Determina como os compradores são redirecionados após cancelar um pagamento.
• Método de pagamento método de renderização
Determina se os métodos de pagamento serão exibidos com seu logotipo ou apenas o nome.
• Idioma local (opcional)
Isso substituirá o local do cliente padrão do armazenamento do Magento.
Deixe vazio para deixar Magento decidir (Ex: nl_NL)
• Código do país ISO (opcional)
Isso irá substituir o país do endereço de faturamento do comprador ao determinar quais métodos de pagamento serão exibidos.
Cartão de Crédito Redecard Komerci Webservice
• Ativar
Para "ativar" ou "desativar" o uso do método
• Ordem de exibição
É a ordem apresentada em métodos de entrega no passo de fechamento de pedido
• Título
Nome do método que deve ser exibido
• Pagamentos aplicáveis aos países
Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países "
• Pagamentos específicos aos países
Você deve selecionar os países que o método deve ser funcional
• Tipos de Cartão de Crédito
Selecione as bandeiras liberadas pela operadora
• Visível em
Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento
• Autenticar
Define se o comprador será direcionado ao Banco emissor para autenticação do cartão
Para pedidos feito no backend não ative essa opção, pois não deve funcionar o redirecionamento para a URL de autenticação
• Ativar Parcelamentos
Define o uso de parcelas
• Parcelas padrão
Para a coluna "Moeda" informe a sigla da moeda por exemplo BRL
Para a coluna "Montante (incl.)" informe o valor mínimo para a exibição da parcela
Para a coluna "Número máximo de parcelas" informe o número de parcelas que será exibida até o valor previamente informando para a exibição da parcela
Para a coluna "Taxa de juros (%) 0.0" informe a taxa de juro usada
A regra para a exibição da parcela é definida com base na faixas de preços
O módulo já vem pré-configurado usando a seguinte regra
Nessa regra
entre R$ 0,00 até R$ 100,00 é exibido 1 parcela entre R$ 101,00 até R$ 200,00 é exibido 2 parcelas entre R$ 201,00 até R$ 600,00 é exibido 3 parcelas entre R$ 601,00 até R$ 800,00 é exibido 4 parcelas entre R$ 801,00 até R$ 10.000,00 é exibido 5 parcelas entre R$ 10.000,00 até R$ 100.000,00 é exibido 6 parcelas
Altere conforme sua necessidade
• Desativar em total geral zero
Desative esta forma de pagamento no checkout quando o total geral da cotação for 0.
Perguntas mais frequentes "FAQ"
Sobre a bandeira Hiper
Como não há biblioteca que faz a leitura desse tipo de cartão, está sendo selecionado essa bandeira caso seja retornado pela biblioteca outro tipo de cartão, foi incluido um validador baseado na bandeira hipercard
Caso essa bandeira venha a apresentar problema talvez seja necessário retirar a automação de seleção de bandeira
AFILIAÇÃO E-COMMERCE - REDECARD
http://www.komerciredecard.com.br
Configurando o produto
No Backend do Magento, acesse o menu: Sistema -> Configuração -> Cerebrum -> Métodos de pagamento -> Redecard -> Preencha os campos solicitados
Dependências
Para se afiliar à Redecard é necessário que o seu site tenha a página segura(SSL128=https).
Por padrão a Redecard libera o Komerci integrado, então para migrar a afiliação para Redecard Webservice basta cadastrar os IPs do Gateway de pagamentos pelo Portal da Redecard ou enviar um e-mail para: pool.credenciamento@redecard.com.br solicitando o cadastramento dos Ips do seu servidor.
Oque fazer após a instalação do módulo ?
Na configuração do método, selecione o ambiente de teste e informe os seguintes dados
Código de filiação Komerci 00000000
Usuário Komerci user
Senha Komerci pass
Para efeito de testes, pode ser usado os seguintes cartões de testes
http://mozg.com.br/dicas/dicas-magento1#cartões-de-crédito-para-testes
Efetue a finalização de um pedido sobre o ambiente de teste onde será feito o processamento da transação
Se foi exibido a tela de finalização quer dizer que foi processado sua transação
Em seguida, configure para o método usar o ambiente de produção
Efetue a finalização de um pedido de R$ 0,01 sobre o ambiente de produção
Operações de Teste (Sandbox)
Apenas o Komerci Webservice permite a realização de testes.
A Redecard recomenda que, para testar o Komerci Integrado, sejam realizadas compras em ambiente de produção e que se execute o estorno até o fim do mesmo dia.
Processo de Homologação
Para a conclusão da configuração Komerci Webservice, deve ser analisado se o estabelecimento está habilitado para a função de captura WebService "SIM" e se os IP os estão cadastrados corretamente.
O cadastramento de IP os pode ser realizado através do portal de serviços Redecard na área restrita e pode ser efetuado o cadastramento de até 10 IPs.
Inicialmente, somente os web-métodos de testes estarão disponíveis, com transações de valor de (1) um centavos.
Para disponibilizar o sistema em produção o estabelecimento deve efetuar uma bateria de testes e os testes devem ser analisados no Relatório de Transações do Komerci.
Se a transação constar com o status "confirmado" significa que os testes foram efetuados com sucesso. Diferente deste status, o desenvolvimento deve ser revisto.
Para confirmar a integração realizada, o cliente deve fazer uma compra teste de 0,01. Após realização de compra, é necessário verificar se a mesma foi lançada em sua conta na Redecard.
Simulação de transação
https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx
https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap_teste.asmx
Simulação de cancelamento
https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx?op=VoidTransaction
curl --header 'Content-Type: text/xml;charset=UTF-8' --header 'VoidTransaction' --data ' <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> soap:Body string string string string string string string </soap:Body> </soap:Envelope>' https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx?wsdl
Simulação de captura
https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx?op=ConfPreAuthorization
curl --header 'Content-Type: text/xml;charset=UTF-8' --header 'ConfPreAuthorization' --data ' <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> soap:Body string string string string string string string string string string </soap:Body> </soap:Envelope>' https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx?wsdl
O que significam os códigos de erro
Verifique no Manual de integração o motivo da ocorrência do erro
Códigos e mensagens de retorno Rede:
As mensagens de bancos e operadoras são genéricas, abaixo disponibilizamos uma pequena lista com erros e retornos mais frequentes sendo que um erro poderá significar algo diferente do que estamos mencionamos.
Se tiveres dúvida ou o erro não constar na lista realize contato com suporte Komerci no telefone 1140014433
23 - Transação não autorizada.
Entre em contato com sua empresa de hospedagem e solicite os IPs de saida que é usado para o seu para o seu site
Verifique no portal da Rede se os IPs de saída do servidor onde está hospedado o site estão configurados corretamente. Caso o acesso seja realizado com a afiliação de sua matriz logue no portal da Rede, selecione o menu "Dados Cadastrais > Acesso às suas filiais" e selecione sua afiliação Komerci no menu "Minha Conta > Informações cadastrais > Clique no botão "Consultar" no box "Dados Cadastrais" > Endereços IP.
Se o erro persistir entre em contato via telefone com o suporte da Redecard informando a ocorrência e solicite se for necessário que seja aberto um chamado para a equipe técnica de gestão de incidentes da Redecard
26 - Transação não autorizada.
Esta mensagem de erro poderá retornar quando:
OS IPs de saída do servidor não estão configurados corretamente no Portal da Rede, veja no item acima como verificar se estão corretos. Os dados de convênio, usuário e senha webservices não estão corretos na administração do Magento.
27 - Cartão Inválido.
O número de cartão informado esta incorreto, por um ou mais dos seguintes motivos:
O cartão de bandeira Mastercard ou Visa não é numérico com 16 posições. O cartão de bandeira Diners não possui de 14 a 16 posições numéricas. O dígito do cartão esta inconsistente.
41 - Transação não autorizada.
Verifique se o usuário Webservice que está configurado no Portal da Rede é o mesmo que está configurado na administração do Magento. Para verificar no portal da Rede acesse o Menu "Dados Cadastrais > Acesso às suas filiais" e selecione sua afiliação Komerci. Localize o menu "Komerci > Usuários do Komerci > Cadastrar usuário". Caso o usuário não esteja cadastrado corretamente, remova e cadastre novamente.
51 - Estabelecimento Inválido. Por favor, entre em contato com o estabelecimento que está efetuando a venda.
Identificamos que está mensagem de erro retornou quando:
O estabelecimento não possui liberação para aceitar cartões emitidos no exterior. Para confirmar se realmente o problema é este realize contato com suporte Komerci Rede e informe sua filiação. Cartão utilizado não tem a função crédito habilitado. Se esta mensagem de erro aparecer em todos os pedidos é possível que estabelecimento não tenha habilitado o gerenciador webservices. O gerenciador é responsável por realizar cancelamentos e pré-autorizar pagamentos na operadora. Poderás identificar se está é a causa através de um teste simples: Na administração do Magento nas configurações dos meio de pagamentos Rede marque a opção Autorizar e Capturar. Após faça um pedido de teste. Funcionou? Então realize contato com o suporte Komerci e informe que deseja habilitar o gerenciador webservices para seu estabelecimento.
53 - Transação Inválida. Por favor, entre em contato com o estabelecimento que está efetuando a venda.
Transação não foi autorizada pelo banco emissor do cartão, possíveis causas: Parcelamento configurado na administração do Magento não está habilitado na operadora. Falta de limite. Cartão não tem habilitado função crédito. Número do cartão inválido.
56 - Dado inválido. Por favor, entre em contato com o estabelecimento que está efetuando a venda.
Pagamento não autorizado pelo banco emissor do cartão.
Na tentativa de reembolso é retornado essa mensagem pois:
Ocorre que o sistema de Liquidação da REDE entende que transações inferiores a R$ 0,10 são vendas de testes e desta forma não realiza a liquidação das transações.
58 - Problemas com o cartão. Por favor, verifique os dados de seu cartão. Caso o erro persista entre em contato com a central de atendimento de seu cartão.
Pagamento não autorizado pelo banco emissor do cartão.
74 - Instituição sem comunicação
Operadora Rede não conseguiu comunicação com o banco emissor do cartão para concluir o processo de pagamento.
78 - Transação não Autorizada
Estabelecimento está com problemas no cadastramento da filiação podendo estar suspensa, cancelada ou não cadastrada no Komerci.
Lembramos que os erros são genéricos, caso tenha dúvida sobre o problema realize contato com a operadora Rede.
Como alterar a imagem do método
Pode ser adicionado a imagem, contendo qualquer uma das nomenclaturas a seguir
- method-creditcard.png
E adicione a imagem no diretório do seu template
/skin/frontend//default/images/mozg_redecard
Dados de contato - Redecard
Suporte Técnico Komerci
REDECARD SA
integracao.ecommerce@userede.com.br
1140014433 (capitais e regiões metropolitanas) Opção 3
0800 784433 (demais localidades)
Obs. Antes de entrar em contato, tenha em mãos seu número de filiação (estabelecimento), caso seja desenvolvedor informe o número do CNPJ da empresa
Havendo alguma ocorrência de erro sugiro enviar e-mail a Redecard informando a ocorrência, caso haja necessidade de efetuar alguma atualização o suporte da Redecard deve apontar o que deve ser feito
Manual
https://www.userede.com.br/atendimento/documentos
Contribuintes
Equipe Mozg
License
Badges
🐈