Integração a Braspag API V2
Atender o mercado de módulos para Magento oferecendo melhorias e um excelente suporte
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
- [✓] Transação
- [✓] Consulta
- [✓] Captura
- [✓] Reembolso
- [✓] Cancelamento
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, caso o pagamento seja confirmado, deve ser alterado o status do pedido para "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
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.
--
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 se essa extensão está ativa em seu servidor
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, 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
--
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-braspag-php55: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 clear-cache && 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-braspag-php55 && composer clear-cache && composer update
--
-
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
Para configurar o método de pagamento, acesse no backend em:
STORES -> Configuration -> Sales/Payment Methods -> Braspag (powered by MOZG)
Você terá os campos a seguir
Deve ser informado o devido ambiente
Efetue o cadastro no seguinte ambiente para obter os dados de integração como: MerchantId e MerchantKey
https://cadastrosandbox.braspag.com.br/
Efetue o cadastro no seguinte ambiente para obter os dados de integração como: MerchantId e MerchantKey
https://cadastrosandbox.braspag.com.br/
A informação deve ser fornecido pela Braspag
A informação deve ser fornecido pela Braspag
Status dos pedidos recém-criados, antes da confirmação de resultado de pagamento via notificações de servidor da operadora
Status dos pedidos após autorização confirmada por uma notificação de AUTORIZAÇÃO da operadora
Status dos pedidos após captura confirmada por uma notificação de AUTORIZAÇÃO da operadora
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
Selecione somente o status atribuído ao estado concluído, deixe vazio para usar o mesmo que os produtos normais
Status dos pedidos após reembolso confirmada por uma notificação de REEMBOLSO da operadora
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 dos pedidos após notificação de PENDENCIA da operadora
Imediato é o padrão
Defina como manual se você quiser executar a captura de fundos manualmente mais tarde
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.
Se você habilitar esta função será feito uma solicitação de captura para a operadora se você fizer o envio
Se uma pedido é cancelada por algum motivo, mas recebeu uma notificação de que o pagamento é autorizado, isso cancelará automaticamente o pedido
Ativar / Desativar reembolso automático ao cancelar um pedido
Ativar / desativar atualizações de e-mails
Ativar / desativar e-mails de atualização para todas as alterações no status do pedido para o cliente
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
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.
Determina como os compradores são redirecionados após cancelar um pagamento.
Determina se os métodos de pagamento serão exibidos com seu logotipo ou apenas o nome.
Isso substituirá o local do cliente padrão do armazenamento do Magento.
Deixe vazio para deixar Magento decidir (Ex: nl_NL)
Isso irá substituir o país do endereço de faturamento do comprador ao determinar quais métodos de pagamento serão exibidos.
Para "ativar" ou "desativar" o uso do método
É a ordem apresentada em métodos de entrega no passo de fechamento de pedido
Nome do método que deve ser exibido
Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países "
Você deve selecionar os países que o método deve ser funcional
Selecione as bandeiras liberadas pela operadora
Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento
Define se o comprador será direcionado ao Banco emissor para autenticação do cartão
Para essa opção é enviado o parâmetro ReturnUrl, não deve funcionar para dominios que contenham caracteres especiais conforme as regras da Cielo
Para pedidos feito no backend não ative essa opção, pois não deve funcionar o redirecionamento para a URL de autenticação
Define o uso de parcelas
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 juro (%)" 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 da seguinte forma
Até R$ 100,00 em 1 parcela
Até R$ 200,00 em 2 parcelas
Até R$ 600,00 em 3 parcelas
Até R$ 800,00 em 4 parcelas
Até R$ 10.000,00 em 5 parcelas
Até R$ 100.000,00 em 6 parcelas
Altere conforme sua necessidade
Desative esta forma de pagamento no checkout quando o total geral da cotação for 0.
Para "ativar" ou "desativar" o uso do método
É a ordem apresentada em métodos de entrega no passo de fechamento de pedido
Nome do método que deve ser exibido
Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países "
Você deve selecionar os países que o método deve ser funcional
Selecione as bandeiras liberadas pela operadora
Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento
Desative esta forma de pagamento no checkout quando o total geral da cotação for 0.
Para "ativar" ou "desativar" o uso do método
É a ordem apresentada em métodos de entrega no passo de fechamento de pedido
Nome do método que deve ser exibido
Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países "
Você deve selecionar os países que o método deve ser funcional
Selecione as bandeiras liberadas pela operadora
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
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
Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento
Para "ativar" ou "desativar" o uso do método
É a ordem apresentada em métodos de entrega no passo de fechamento de pedido
Nome do método que deve ser exibido
Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países "
Você deve selecionar os países que o método deve ser funcional
Selecione as bandeiras liberadas pela operadora
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
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
Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento
Para cancelar um pedido pelo magento, acesse a fatura previamente criada e clique no botão "Cancelar" em seguida acesse o pedido e clique no botão "Cancelar
Acesse a fatura previamente criada e clique no botão "Reembolso"
Obs. o botão "Reembolso" só deve ser exibido quando tiver sido feito a captura
Na necessidade de exibição de parcela na página de produto, talvez o seguinte módulo deva atender sua necessidade
https://www.magentocommerce.com/magento-connect/preco-parcelado-1.html
Que pode ser instalado via composer
Para instalar o módulo via composer execute o seguinte comando na raiz do projeto
composer require connect20/franciscoprado_precoparcelado
Crie uma conta de teste em
https://cadastrosandbox.braspagecommerce.braspag.com.br/
Onde será fornecido o seu MerchantId e MerchantKey
Configure no método o seu MerchantId e MerchantKey
Efetue um teste
Se foi exibido a tela de finalização quer dizer que foi processado sua transação
Faça interação junto a Braspag solicitando homologação dessa integração e solicitando os dados para ser usados em ambiente de produção
Pode ser adicionado a imagem, contendo qualquer uma das nomenclaturas a seguir
- method-boleto.png
- method-creditcard.png
- method-debitcard.png
- method-eletronictransfer.png
E adicione a imagem no diretório do seu template
/skin/frontend//default/images/mozg_braspag
implantacao.operacoes@braspag.com.br
Rodolfo de Lucena - rmoreira@braspag.com.br - 11 3320-9058
ou acesse
ou acesse
Para entrar em contato com a Braspag
http://www.braspag.com.br/suporte/desenvolvedores/
http://apidocs.braspag.com.br/
Equipe Mozg
🐈