Magento
#
IntroduçãoNeste guia vamos descrever o passo-a-passo para que você possa utilizar PicPay dentro do seu e-commerce com Magento 1 ou 2.
#
Antes de começarAntes de iniciar sua integração, você deve possuir credenciais válidas. Você pode conferir como obter suas credenciais neste artigo.
#
Como utilizar#
Acessar a página oficial dos plugins do GitHub- Link para Magento 1: https://github.com/PicPay/magento1
- Link para Magento 2: https://github.com/PicPay/magento2
#
Instalação para Magento 1Para configurar o PicPay como forma de pagamento no Magento 1 disponibilizamos duas opções:
CDN
Efetue o download de nosso plugin através de nosso CDN e copie os arquivos para seu ambiente: https://cdn.picpay.com/ecommerce/Picpay_Payment-1.0.2.tgz
Composer
Efetue a instalação utilizando Composer.
#
Instalação para Magento 2Composer
Efetue a instalação utilizando Composer.
Passo 1
Passo 2
Passo 3
Passo 4
#
Instalação manual para Magento 2Essa primeira etapa faça apenas se seu Magento não tem o Laminas (versões menores que o 2.3.5).
Caso seu magento não tenha o Laminas, instale a dependência
Passo 1
Passo 2
Passo 3
Realize o download do arquivo no GitHub e cole os arquivos na pasta app/code/Picpay/Payment.
Depois rode os comandos de instalação abaixo:
Passo 1
Passo 2
Passo 3
#
ConfiguraçõesPara realizar a configuração do módulo PicPay para Magento 2, acesse:
- Painel Administrador > Vendas > Picpay > Configurações > localize a opção PicPay dentro do menu Outros meios de Pagamento;
- Em seguida, no menu PicPay, clique em Credenciais e Configurações Gerais;
Atenção: Esta configuração habilita a utilização do módulo PicPay.
- Insira as credenciais usadas para os serviços do PicPay (API Token do PicPay e Seller Token do PicPay), caso você não tenha a mesma é necessário entrar em contato com o método de pagamento.
#
Credenciais e Configurações GeraisAbaixo os detalhes de cada configuração:
- Título: Insira o título da configuração;
- API Token do PicPay: Insira o API Token do PicPay;
- Seller Token do PicPay: Insira o Seller Token do PicPay;
- Horas para Expirar: Horas para expirar a transação (apenas números);
- Status para novos pedidos: Status atribuído aos pedidos recém-criados antes da confirmação do pagamento, via notificações do servidor;
- Pagamento de países aplicáveis: Insira aqui os países onde o pagamento é aplicável;
- Habilitar notificação de status do pedido: Marque esta opção se deseja habilitar a notificação do status do pedido;
- Habilitar log de debug: Ao ativar esta função, os logs serão registrados no servidor para fins de depuração.
#
Configurações de Checkout e LayoutNeste campo você irá configurar o comportamento do checkout:
- Modalidade de Checkout: Determine a página onde o processo de pagamento ocorrerá.
- Largura do QRCode no "Modo na mesma Página (transparente)": Especifique o tamanho do QRCode em pixels para o modo de checkout transparente. Utilize apenas números.
- Largura do QRCode na página de informações de pagamento: Defina o tamanho do QRCode em pixels para a página de informações de pagamento. Utilize apenas números.
- Usar Texto Personalizado no Formulário: Ative esta opção se deseja exibir uma mensagem personalizada na página de Checkout.
- Mostrar QRCode na Página de Sucesso: Determine se deseja exibir o QRCode na página de sucesso.
- Mensagem para mostrar junto ao QRCode na página de sucesso: Insira a mensagem que será exibida ao lado do QRCode na página de sucesso.
#
LogsNesta funcionalidade apresentamos os Callbacks no menu de opções do Magento. Caso tenha algum retorno de erro, por exemplo estorno/reembolso ou captura, o registro do erro encontra-se no arquivo de logs do próprio Magento.
- Caminho:
pasta_raiz_do_magento/var/logs
#
CallbacksAtravés do menu abaixo, é possível visualizar o payload de callback retornado para PicPay.
- Caminho: Vendas > PicPay > Callbacks
#
Próximos passos- Entenda os possíveis status de um pagamento;
- Entenda como solicitar um cancelamento total;
- Entenda um pouco mais sobre as notificações que o PicPay envia;
#
Obtendo ajudaEsperamos ter ajudado com este artigo! Caso tenha restado alguma dúvida, você pode consultar o nosso FAQ ou entrar em contato através do e-mail relacionamento-negocios@picpay.com
Adicionalmente, você também pode abrir um issue em nossos repositórios de Magento 1 ou Magento 2.