, (*1)
Mozg\Pagseguro
Sinopse
Integração a Pagseguro API, (*2)
Demonstração
, (*3)
Motivação
Atender o mercado de módulos para Magento oferecendo melhorias e um excelente suporte, (*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)
Quais os recursos do módulo
- [✓] Transação
- [✓] Captura
- [✓] Consulta
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, 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, (*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)
Setup Cron
Para o uso do método é necessário ativar a CRON para o Magento, (*12)
Clique aqui para visualizar o documento da MOZG, (*13)
Certifique-se de que ação esteja sendo executado a cada minuto, (*14)
Esse módulo usa o cronjob para processar as notificações, (*15)
O módulo executa as notificações que foram recebidas há pelo menos 5 minutos., (*16)
Instalação - Atualização - Desinstalação - Desativação
--, (*17)
Este módulo destina-se a ser instalado usando o Composer, (*18)
Execute o seguinte comando no terminal, para visualizar a existencia do Composer e sua versão, (*19)
composer --version
Caso não tenha o Composer em seu ambiente, sugiro ler o seguinte artigo Clique aqui, (*20)
--, (*21)
É necessário que o servidor tenha o suporte a extensão ionCube PHP Loader, (*22)
Para visualizar se essa extensão está ativa em seu servidor, (*23)
Certique se da presença do arquivo phpinfo.php na raiz do seu projeto, (*24)
<?php phpinfo(); ?>
Caso não exista o arquivo phpinfo.php na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima, (*25)
Acesse o arquivo pelo browser, (*26)
Em seguida pesquise pelo termo "ionCube PHP Loader", (*27)
Caso o seu servidor não tenha o suporte a extensão, Clique aqui, (*28)
Em "Loader Downloads API", efetue download do pacote compatível com o seu servidor, (*29)
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, (*30)
Clique aqui para ver os processos executados, (*31)
--, (*32)
Para utilizar o(s) módulo(s) da MOZG é necessário aceitar o Acordo de licença do usuário final, (*33)
--, (*34)
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, (*35)
--, (*36)
Sugiro efetuar backup da plataforma Magento e do banco de dados, (*37)
--, (*38)
Antes de efetuar qualquer atualização no Magento sempre mantenha o Compiler e o Cache desativado, (*39)
--, (*40)
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, (*41)
{
"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, (*42)
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-pagseguro-php56:dev-master
Você pode verificar se o módulo está instalado, indo ao backend em:, (*43)
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--, (*44)
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, (*45)
composer clear-cache && composer update
Na ocorrência de erro, renomeie a pasta /vendor/mozgbrasil e execute novamente, (*46)
Para checar a data do módulo execute o seguinte comando, (*47)
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--, (*48)
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-pagseguro-php56 && composer clear-cache && composer update
--, (*49)
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, (*50)
-
Caso queira desativar os módulos da MOZG renomeie a seguinte pasta app/code/local/Mozg, (*51)
A desativação do módulo pode ser usado para detectar se determinada ocorrência tem relação com o módulo, (*52)
Como configurar o método de pagamento
Para configurar o método de pagamento, acesse no backend em:, (*53)
STORES -> Configuration -> Sales/Payment Methods -> Pagseguro (powered by MOZG)
Você terá os campos a seguir, (*54)
Pagseguro API V2 - Configurações Padrão
Configurações necessárias
• Modo Teste ou Produção
Deve ser informado o devido ambiente, (*55)
• e-mail para o ambiente de teste
e-mail para o ambiente de teste, (*56)
• token para o ambiente de teste
token para o ambiente de teste, (*57)
• e-mail para o ambiente de produção
e-mail para o ambiente de produção, (*58)
• token para o ambiente de produção
token para o ambiente de produção, (*59)
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, (*60)
• Status do pedido: autorização de pagamento
Status dos pedidos após autorização confirmada por uma notificação de AUTORIZAÇÃO da operadora, (*61)
• Status do pedido: pagamento confirmado
Status dos pedidos após captura confirmada por uma notificação de AUTORIZAÇÃO da operadora, (*62)
• Status do pedido: cancelamento de pedido
Status dos pedidos após cancelamento confirmada por uma notificação de CANCELAMENTO da operadora, (*63)
Se as encomendas já estiverem faturadas, não poderão ser canceladas, (*64)
• 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, (*65)
• Status do pedido: Reembolsado
Status dos pedidos após reembolso confirmada por uma notificação de REEMBOLSO da operadora, (*66)
• 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., (*67)
• Status do pedido: pedidos pendentes
Status dos pedidos após notificação de PENDENCIA da operadora, (*68)
• Tipo de Captura
Imediato é o padrão, (*69)
Defina como manual se você quiser executar a captura de fundos manualmente mais tarde, (*70)
• Criar uma fatura pendente (apenas para captura manual)
Isso criará uma fatura pendente se a notificação de AUTORIZAÇÃO for recebida., (*71)
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., (*72)
• 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, (*73)
• 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, (*74)
• Cancelamento\Reembolso automático quando o pedido é cancelado
Ativar / Desativar reembolso automático ao cancelar um pedido, (*75)
• E-mail da fatura
Ativar / desativar atualizações de e-mails, (*76)
• Enviar e-mail de notificaçao do status do pedido
Ativar / desativar e-mails de atualização para todas as alterações no status do pedido para o cliente, (*77)
• Ativar log de depuração
Deve ser armazenado os processos do módulo em var/log/, (*78)
O arquivo, (*79)
DATE_mozg.log, (*80)
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, (*81)
O arquivo, (*82)
payment_METHOD.log, (*83)
Avançado: Pagseguro 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., (*84)
Avançao: Experiência de Checkout
• Redirecionar o destino após o cancelamento
Determina como os compradores são redirecionados após cancelar um pagamento., (*85)
• 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., (*86)
• Idioma local (opcional)
Isso substituirá o local do cliente padrão do armazenamento do Magento., (*87)
Deixe vazio para deixar Magento decidir (Ex: nl_NL), (*88)
• 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., (*89)
Cartão de Crédito Pagseguro
• Ativar
Para "ativar" ou "desativar" o uso do método, (*90)
• Ordem de exibição
É a ordem apresentada em métodos de entrega no passo de fechamento de pedido, (*91)
• Título
Nome do método que deve ser exibido, (*92)
• 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 ", (*93)
• Pagamentos específicos aos países
Você deve selecionar os países que o método deve ser funcional, (*94)
• Tipos de Cartão de Crédito
Selecione as bandeiras liberadas pela operadora, (*95)
• Visível em
Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento, (*96)
• Autenticar
Define se o comprador será direcionado ao Banco emissor para autenticação do cartão, (*97)
Para essa opção é enviado o parâmetro ReturnUrl, não deve funcionar para dominios que contenham caracteres especiais conforme as regras da Cielo, (*98)
Para pedidos feito no backend não ative essa opção, pois não deve funcionar o redirecionamento para a URL de autenticação, (*99)
• Ativar Parcelamentos
Define o uso de parcelas, (*100)
• Parcelas padrão
Para a coluna "Moeda" informe a sigla da moeda por exemplo BRL, (*101)
Para a coluna "Montante (incl.)" informe o valor mínimo para a exibição da parcela, (*102)
Para a coluna "Número máximo de parcelas" informe o número de parcelas que sera exibida até o valor previamente informando para a exibição da parcela, (*103)
Para a coluna "Taxa de juro (%)" informe a taxa de juro usada, (*104)
O módulo já vem pré-configurado da seguinte forma, (*105)
Até R$ 100,00 em 1 parcela, (*106)
Até R$ 200,00 em 2 parcelas, (*107)
Até R$ 600,00 em 3 parcelas, (*108)
Até R$ 800,00 em 4 parcelas, (*109)
Até R$ 10.000,00 em 5 parcelas, (*110)
Até R$ 100.000,00 em 6 parcelas, (*111)
Altere conforme sua necessidade, (*112)
• Desativar em total geral zero
Desative esta forma de pagamento no checkout quando o total geral da cotação for 0., (*113)
Cartão de Débito Pagseguro
• 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)
• Tipos de Cartão de Débito
Selecione as bandeiras liberadas pela operadora, (*119)
• Visível em
Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento, (*120)
• Ativar Parcelamentos
Define o uso de parcelas, (*121)
• Parcelas padrão
Para a coluna "Moeda" informe a sigla da moeda por exemplo BRL, (*122)
Para a coluna "Montante (incl.)" informe o valor para a exibição da parcela, (*123)
Para a coluna "Número máximo de parcelas" informe o número de parcelas que sera exibida até o valor previamente informando para a exibição da parcela, (*124)
Para a coluna "Taxa de juro (%)" informe a taxa de juro usada, (*125)
• Desativar em total geral zero
Desative esta forma de pagamento no checkout quando o total geral da cotação for 0., (*126)
Boleto Pagseguro
• Ativar
Para "ativar" ou "desativar" o uso do método, (*127)
• Ordem de exibição
É a ordem apresentada em métodos de entrega no passo de fechamento de pedido, (*128)
• Título
Nome do método que deve ser exibido, (*129)
• 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 ", (*130)
• Pagamentos específicos aos países
Você deve selecionar os países que o método deve ser funcional, (*131)
• Tipos de Boleto
Selecione as bandeiras liberadas pela operadora, (*132)
• 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, (*133)
• 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, (*134)
• Visível em
Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento, (*135)
Transferência Eletrônica Pagseguro
• Ativar
Para "ativar" ou "desativar" o uso do método, (*136)
• Ordem de exibição
É a ordem apresentada em métodos de entrega no passo de fechamento de pedido, (*137)
• Título
Nome do método que deve ser exibido, (*138)
• 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 ", (*139)
• Pagamentos específicos aos países
Você deve selecionar os países que o método deve ser funcional, (*140)
• Tipos de Transferência Eletrônica
Selecione as bandeiras liberadas pela operadora, (*141)
• 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, (*142)
• 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, (*143)
• Visível em
Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento, (*144)
Perguntas mais frequentes "FAQ"
Sobre Ativar Parcela do Produto na Vitrine
Na necessidade de exibição de parcela na página de produto, talvez o seguinte módulo deva atender sua necessidade, (*145)
https://www.magentocommerce.com/magento-connect/preco-parcelado-1.html, (*146)
Que pode ser instalado via composer, (*147)
Para instalar o módulo via composer execute o seguinte comando na raiz do projeto, (*148)
composer require connect20/franciscoprado_precoparcelado
Oque fazer após a instalação do módulo ?
-
Para o ambiente de teste, (*149)
Se logue em, (*150)
https://pagseguro.uol.com.br/, (*151)
Em seguida acesse, (*152)
https://sandbox.pagseguro.uol.com.br/vendedor/configuracoes.html, (*153)
Nesse ambiente é exibido o token, (*154)
Em seguida acesse, (*155)
https://sandbox.pagseguro.uol.com.br/comprador-de-testes.html, (*156)
Sempre utilize esses dados de comprador e cartão de crédito para os testes, (*157)
-
Para o ambiente de produção, (*158)
https://pagseguro.uol.com.br/, (*159)
Como alterar a imagem do método
Pode ser adicionado a imagem, contendo qualquer uma das nomenclaturas a seguir, (*160)
- method-boleto.png
- method-creditcard.png
- method-debitcard.png
- method-eletronictransfer.png
E adicione a imagem no diretório do seu template, (*161)
/skin/frontend//default/images/mozg_pagseguro, (*162)
Dados de contato - Pagseguro
Para entrar em contato com a Pagseguro, (*163)
Manual
https://dev.pagseguro.uol.com.br/documentacao, (*164)
https://dev.pagseguro.uol.com.br/documentacao/pagamento-online/pagamentos, (*165)
https://dev.pagseguro.uol.com.br/documentacao/pagamento-online/pagamentos/pagamento-transparente, (*166)
Contribuintes
Equipe Mozg, (*167)
License
Comercial License, (*168)
Badges
, (*169)
:cat2:, (*170)