2017 © Pedro Peláez
 

magento-module magento-redecard-php_54

Integração ao redecard

image

mozgbrasil/magento-redecard-php_54

Integração ao redecard

  • Friday, July 27, 2018
  • by mozgbrasil
  • Repository
  • 1 Watchers
  • 0 Stars
  • 25 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 1 Forks
  • 0 Open issues
  • 2 Versions
  • 32 % Grown

The README.md

valid XHTML, (*1)

Mozg\Redecard

Sinopse

Integração a Redecard, (*2)

Motivação

Atender o mercado de módulos para Magento oferecendo melhorias e um excelente suporte, (*3)

Demonstração

Clique para visualizar o vídeo, (*4)

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, (*5)

Preço

Clique aqui, (*6)

Recursos do módulo

  • [✓] Transação
  • [✓] Consulta
  • [✓] Captura
  • [✓] Reembolso
  • [✓] Cancelamento

Característica técnica

No checkout é feito o processo de autorização, (*7)

No retorno de "Transação autorizada" é feito redirecionamento para a página de sucesso, (*8)

Na página de sucesso é enviado infomações para o recurso de notificação da transação, (*9)

Via CRON deve ser processado a notificação da transação,, (*10)

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, (*11)

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, (*12)

Quando o pedido é enviado o status é alterado para "complete" ou seja "Completo", (*13)

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, (*14)

Setup Cron

Para o uso do método é necessário ativar a CRON para o Magento, (*15)

Clique aqui para visualizar o documento da MOZG, (*16)

Certifique-se de que ação esteja sendo executado a cada minuto, (*17)

Esse módulo usa o cronjob para processar as notificações, (*18)

O módulo executa as notificações que foram recebidas há pelo menos 5 minutos., (*19)

Testando na Heroku

Gostaria de apresentar o aplicativo que disponibilizei para a plataforma Heroku, (*20)

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, (*21)

https://github.com/mozgbrasil/heroku-magento#descrição, (*22)

Instalação - Atualização - Desinstalação - Desativação

--, (*23)

Sugiro "printar" as telas com todos os procedimentos executados, (*24)

Envie para nós as imagens das telas na eventualidade de quaisquer dificuldades, (*25)

--, (*26)

Este módulo destina-se a ser instalado usando o Composer, (*27)

Execute o seguinte comando no terminal, para visualizar a existencia do Composer e sua versão, (*28)

composer --version

Caso não tenha o Composer em seu ambiente, sugiro ler o seguinte artigo Clique aqui, (*29)

--, (*30)

É necessário que o servidor tenha o suporte a extensão ionCube PHP Loader, (*31)

Para visualizar a existência da extensão nesse ambiente denominado PHP CLI, execute o seguinte comando no terminal, (*32)

php -v

Para visualizar se essa extensão está ativa em seu servidor no ambiente denominado PHP WEB, (*33)

Certique se da presença do arquivo phpinfo.php na raiz do seu projeto, (*34)

<?php phpinfo(); ?>

Caso não exista o arquivo phpinfo.php na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima, (*35)

Acesse o arquivo pelo browser, (*36)

Em seguida pesquise pelo termo "ionCube PHP Loader", (*37)

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, (*38)

Caso tenha a permissão e queira ativar a extensão, Clique aqui, (*39)

Em "Loader Downloads API", efetue download do pacote compatível com o seu servidor, (*40)

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, (*41)

Clique aqui para ver os processos executados, (*42)

--, (*43)

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, (*44)

https://raw.githubusercontent.com/mozgbrasil/heroku-magento/master/phpinfo-ioncube-encoder10-x86-64-php_54.php, (*45)

--, (*46)

Para utilizar o(s) módulo(s) da MOZG é necessário aceitar o Acordo de licença do usuário final, (*47)

--, (*48)

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, (*49)

--, (*50)

Sugiro efetuar backup da plataforma Magento e do banco de dados, (*51)

--, (*52)

Antes de efetuar qualquer atualização no Magento sempre mantenha o Compiler e o Cache desativado, (*53)

--, (*54)

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, (*55)

{
  "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, (*56)

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:, (*57)

STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output

--, (*58)

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, (*59)

composer update

Na ocorrência de erro, renomeie a pasta /vendor/mozgbrasil e execute novamente, (*60)

Para checar a data do módulo execute o seguinte comando, (*61)

grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil

--, (*62)

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

--, (*63)

Para desativar o módulo

  1. Antes de efetuar qualquer processo que envolva atualização sobre o Magento é necessário manter o Compiler e Cache desativado, (*64)

  2. Caso queira desativar os módulos da MOZG renomeie a seguinte pasta app/code/local/Mozg, (*65)

A desativação do módulo pode ser usado para detectar se determinada ocorrência tem relação com o módulo, (*66)

Como configurar o método de pagamento

Para configurar o método de pagamento, acesse no backend em:, (*67)

STORES -> Configuration -> Sales/Payment Methods -> Redecard (powered by MOZG)

Você terá os campos a seguir, (*68)

Redecard - Configurações Padrão

Configurações necessárias

Modo Teste ou Produção

Deve ser informado o devido ambiente, (*69)

Código de filiação Komerci

Informe o seu código de filiação, (*70)

Usuário Komerci

Informe o usuário de acesso a Redecard, (*71)

Senha Komerci

Informe a senha de acesso a Redecard, (*72)

Os dados de usuário e senha é usado para o tipo de captura manual, (*73)

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, (*74)

Status do pedido: autorização de pagamento

Status dos pedidos após autorização confirmada por uma notificação de AUTORIZAÇÃO da operadora, (*75)

Status do pedido: pagamento confirmado

Status dos pedidos após captura confirmada por uma notificação de AUTORIZAÇÃO da operadora, (*76)

Status do pedido: cancelamento de pedido

Status dos pedidos após cancelamento confirmada por uma notificação de CANCELAMENTO da operadora, (*77)

Se as encomendas já estiverem faturadas, não poderão ser canceladas, (*78)

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, (*79)

Status do pedido: Reembolsado

Status dos pedidos após reembolso confirmada por uma notificação de REEMBOLSO da operadora, (*80)

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., (*81)

Status do pedido: pedidos pendentes

Status dos pedidos após notificação de PENDENCIA da operadora, (*82)

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, (*83)

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", (*84)

Criar uma fatura pendente (apenas para captura manual)

Isso criará uma fatura pendente se a notificação de AUTORIZAÇÃO for recebida., (*85)

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., (*86)

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, (*87)

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, (*88)

Cancelamento\Reembolso automático quando o pedido é cancelado

Ativar / Desativar reembolso automático ao cancelar um pedido, (*89)

E-mail da fatura

Ativar / desativar atualizações de e-mails, (*90)

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, (*91)

Ativar log de depuração

Deve ser armazenado os processos do módulo em var/log/, (*92)

O arquivo, (*93)

DATE_mozg.log, (*94)

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, (*95)

O arquivo, (*96)

payment_METHOD.log, (*97)

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., (*98)

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., (*99)

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., (*100)

Idioma local (opcional)

Isso substituirá o local do cliente padrão do armazenamento do Magento., (*101)

Deixe vazio para deixar Magento decidir (Ex: nl_NL), (*102)

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., (*103)

Cartão de Crédito Redecard Komerci Webservice

Ativar

Para "ativar" ou "desativar" o uso do método, (*104)

Ordem de exibição

É a ordem apresentada em métodos de entrega no passo de fechamento de pedido, (*105)

Título

Nome do método que deve ser exibido, (*106)

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 ", (*107)

Pagamentos específicos aos países

Você deve selecionar os países que o método deve ser funcional, (*108)

Tipos de Cartão de Crédito

Selecione as bandeiras liberadas pela operadora, (*109)

Visível em

Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento, (*110)

Autenticar

Define se o comprador será direcionado ao Banco emissor para autenticação do cartão, (*111)

Para pedidos feito no backend não ative essa opção, pois não deve funcionar o redirecionamento para a URL de autenticação, (*112)

Ativar Parcelamentos

Define o uso de parcelas, (*113)

Parcelas padrão

Para a coluna "Moeda" informe a sigla da moeda por exemplo BRL, (*114)

Para a coluna "Montante (incl.)" informe o valor mínimo para a exibição da parcela, (*115)

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, (*116)

Para a coluna "Taxa de juros (%) 0.0" informe a taxa de juro usada, (*117)

-, (*118)

A regra para a exibição da parcela é definida com base na faixas de preços, (*119)

O módulo já vem pré-configurado usando a seguinte regra, (*120)

Nessa regra, (*121)

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, (*122)

Altere conforme sua necessidade, (*123)

-, (*124)

Desativar em total geral zero

Desative esta forma de pagamento no checkout quando o total geral da cotação for 0., (*125)

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, (*126)

Caso essa bandeira venha a apresentar problema talvez seja necessário retirar a automação de seleção de bandeira, (*127)

AFILIAÇÃO E-COMMERCE - REDECARD

http://www.komerciredecard.com.br, (*128)

Configurando o produto

No Backend do Magento, acesse o menu: Sistema -> Configuração -> Cerebrum -> Métodos de pagamento -> Redecard -> Preencha os campos solicitados, (*129)

Dependências

Para se afiliar à Redecard é necessário que o seu site tenha a página segura(SSL128=https)., (*130)

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., (*131)

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, (*132)

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, (*133)

http://mozg.com.br/dicas/dicas-magento1#cartões-de-crédito-para-testes, (*134)

Efetue a finalização de um pedido sobre o ambiente de teste onde será feito o processamento da transação, (*135)

Se foi exibido a tela de finalização quer dizer que foi processado sua transação, (*136)

Em seguida, configure para o método usar o ambiente de produção, (*137)

Efetue a finalização de um pedido de R$ 0,01 sobre o ambiente de produção, (*138)

Operações de Teste (Sandbox)

Apenas o Komerci Webservice permite a realização de testes., (*139)

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., (*140)

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., (*141)

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., (*142)

Inicialmente, somente os web-métodos de testes estarão disponíveis, com transações de valor de (1) um centavos., (*143)

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., (*144)

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., (*145)

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., (*146)

Simulação de transação

https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx, (*147)

https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap_teste.asmx, (*148)

Simulação de cancelamento

https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx?op=VoidTransaction, (*149)

curl --header 'Content-Type: text/xml;charset=UTF-8' --header 'VoidTransaction' --data ' string string string string string string string ' https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx?wsdl, (*150)

Simulação de captura

https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx?op=ConfPreAuthorization, (*151)

curl --header 'Content-Type: text/xml;charset=UTF-8' --header 'ConfPreAuthorization' --data ' string string string string string string string string string string ' https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx?wsdl, (*152)

O que significam os códigos de erro

Verifique no Manual de integração o motivo da ocorrência do erro, (*153)

Códigos e mensagens de retorno Rede:, (*154)

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., (*155)

Se tiveres dúvida ou o erro não constar na lista realize contato com suporte Komerci no telefone 1140014433, (*156)

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, (*157)

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., (*158)

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, (*159)

26 - Transação não autorizada.

Esta mensagem de erro poderá retornar quando:, (*160)

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., (*161)

27 - Cartão Inválido.

O número de cartão informado esta incorreto, por um ou mais dos seguintes motivos:, (*162)

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., (*163)

#### 41 - Transação não autorizada., (*164)

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., (*165)

#### 51 - Estabelecimento Inválido. Por favor, entre em contato com o estabelecimento que está efetuando a venda., (*166)

Identificamos que está mensagem de erro retornou quando:, (*167)

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., (*168)

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., (*169)

56 - Dado inválido. Por favor, entre em contato com o estabelecimento que está efetuando a venda.

*, (*170)

Pagamento não autorizado pelo banco emissor do cartão., (*171)

*, (*172)

Na tentativa de reembolso é retornado essa mensagem pois:, (*173)

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., (*174)

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., (*175)

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., (*176)

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., (*177)

Lembramos que os erros são genéricos, caso tenha dúvida sobre o problema realize contato com a operadora Rede., (*178)

Como alterar a imagem do método

Pode ser adicionado a imagem, contendo qualquer uma das nomenclaturas a seguir, (*179)

  • method-creditcard.png

E adicione a imagem no diretório do seu template, (*180)

/skin/frontend/, (*181)

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), (*182)

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, (*183)

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, (*184)

Manual

https://www.userede.com.br/atendimento/documentos, (*185)

Contribuintes

Equipe Mozg, (*186)

License

Comercial License, (*187)

Badges

Join the chat at https://gitter.im/mozgbrasil Latest Stable Version Total Downloads Latest Unstable Version License Monthly Downloads Daily Downloads Reference Status Dependency Status, (*188)

:cat2:, (*189)

The Versions

27/07 2018

dev-master

9999999-dev http://mozg.com.br

Integração ao redecard

  Sources   Download

proprietary

The Requires

 

payment magento redecard pagamento cerebrum mozg

01/03 2018

1.0.0

1.0.0.0 http://mozg.com.br

Integração ao redecard

  Sources   Download

proprietary

The Requires

 

payment magento redecard pagamento cerebrum mozg