mozgbrasil/magento-bancodobrasil-php_54

Integração ao bancodobrasil

, _(*1)

Mozg\Bancodobrasil

Sinopse

Integração a Bancodobrasil Comércio Eletrônico, _(*2)

Motivação

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

Demonstração

, _(*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

Característica técnica

Conforme video demonstrativo, _(*7)

Na página de sucesso é enviado infomações para o banco, _(*8)

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

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

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

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

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

Setup Cron

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

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

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

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

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

Testando na Heroku

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

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

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

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

--, _(*22)

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

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

--, _(*25)

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

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

composer --version

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

--, _(*29)

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

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

php -v

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

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

<?php phpinfo(); ?>

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

Acesse o arquivo pelo browser, _(*35)

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

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

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

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

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

Clique aqui para ver os processos executados, _(*41)

--, _(*42)

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

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

--, _(*45)

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

--, _(*47)

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

--, _(*49)

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

--, _(*51)

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

--, _(*53)

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

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

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-bancodobrasil-php_54:dev-master

Você pode verificar se o módulo está instalado, indo ao backend em:, _(*56)

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

--, _(*57)

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

composer update

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

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

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

--, _(*61)

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-bancodobrasil-php_54

--, _(*62)

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

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

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

Como configurar o método de pagamento

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

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

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

Banco do Brasil Comércio Eletrônico - Configurações Padrão

Configurações necessárias

• Modo Teste ou Produção

Deve ser informado o devido ambiente, _(*68)

• Código do convênio de Comércio Eletrônico

Código do convênio de Comércio Eletrônico, _(*69)

• Código de cobrança de Comércio Eletrônico

Código de cobrança de Comércio Eletrônico, _(*70)

• Vencimento (em dias)

Vencimento (em dias), _(*71)

• Observação

Observação, _(*72)

• Tipo de título que originará o boleto

Tipo de título que originará o boleto, _(*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: Bancodobrasil 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)

Banco do Brasil (Todas as opções)

• 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)

Boleto Banco do Brasil

• Ativar

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

• Ordem de exibição

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

• Título

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

• 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 ", _(*112)

• Pagamentos específicos aos países

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

Boleto Bancodobrasil

• Ativar

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

• Ordem de exibição

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

• Título

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

• 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 ", _(*117)

• Pagamentos específicos aos países

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

• Status do pedido não pago

Com Boleto é possível pagar menos do que o valor total. Selecione aqui o status, se este for o caso. Se você deixar isso em branco, ele tomará o status de pedido de pagamento autorizado como status padrão, _(*119)

• Status do pedido pago em excesso

Com Boleto é possível pagar mais do que o valor total. Selecione aqui o status, se este for o caso. Se você deixar isso em branco, ele tomará o status de pedido de pagamento autorizado como status padrão, _(*120)

• Visível em

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

Transferência Eletrônica Bancodobrasil

• Ativar

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

• Ordem de exibição

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

• Título

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

• 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 ", _(*125)

• Pagamentos específicos aos países

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

• Status do pedido não pago

Com Boleto é possível pagar menos do que o valor total. Selecione aqui o status, se este for o caso. Se você deixar isso em branco, ele tomará o status de pedido de pagamento autorizado como status padrão, _(*127)

• Status do pedido pago em excesso

Com Boleto é possível pagar mais do que o valor total. Selecione aqui o status, se este for o caso. Se você deixar isso em branco, ele tomará o status de pedido de pagamento autorizado como status padrão, _(*128)

• Visível em

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

Perguntas mais frequentes "FAQ"

Oque fazer após a instalação do módulo ?

Configure no método o seu Código do convênio e ative o método, _(*130)

Efetue um teste, _(*131)

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

Obs., _(*133)

Para boleto não é possivel efetuar a consultar da transação, devendo ser processada fatura manualmente

Simulações

Temos a possibilidade de fazer simulações de integrações em, _(*134)

http://loja.cerebrum.com.br/vendor/mozgbrasil/php-framework-php_56/examples/bb/Transacao.php

Ao informar o, _(*135)

idConv: ???
refTran:

Ao postar e ao clicar na opção Boleto é retornado, _(*136)

CPF do pagador nao encontrado na base. (C008-000)

Alterei os parametros para, _(*137)

indicadorPessoa: 2
cpfCnpj: 59.729.997/0001-68

Ao postar e ao clicar na opção Boleto é retornado, _(*138)

CPF/CNPJ não informado para cobrança registrada (C031-000)

Alterei os parametros para, _(*139)

indicadorPessoa: 2
cpfCnpj: 16619423000124

Ao postar e ao clicar na opção Boleto é retornado, _(*140)

CNPJ pagador informado inexistente. (C008-000)

Alterei os parametros para, _(*141)

indicadorPessoa: 2
cpfCnpj: 16619423000124
tpPagamento: 21

E foi exibido o Boleto, _(*142)

Em simulações foi feito uma requisição tendo o seguinte erro, _(*143)

UF informada no endereco pagador diferent (C008-000)

Isso acontece devido o CEP informado não ser da cidade informada, _(*144)

Isso é um controle do Banco do Brasil por isso é importante o sistema ter um bom suporte ao dados oque deve impedir o uso de dados discrepantes, _(*145)

Como alterar a imagem do método

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

• method-boleto.png
• method-creditcard.png
• method-debitcard.png
• method-eletronictransfer.png

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

/skin/frontend/, _(*148)

Observações

O processo da transação do pagamento é feito no sistema do Banco do Brasil e é aberto em popup., _(*149)

Na eventualidade do navegador do usuário estiver habilitado o recurso de bloqueio de popup, será exibido um "aviso", induzindo o usuário ao clique para desbloqueio automático do popup., _(*150)

Dados de contato - Bancodobrasil

Deve ligar para 11 4004 0006, opção 8, opção 4, informar agencia e conta, opção 8, informar a chave J, _(*151)

Informado a ocorrência onde deve ser aberto um protocolo, _(*152)

Possível pode ser necessário o envio da ocorrência para o e-mail, suporte.clientes@bb.com.br, informando o protocolo e a ocorrência, _(*153)

Manual

http://bb.com.br/portalbb/page44,3766,2229,0,0,1,2.bb, _(*154)

Contribuintes

Equipe Mozg, _(*155)

License

Comercial License, _(*156)

Badges

, _(*157)

:cat2:, _(*158)