Configurações Shipay e Magento: Guia de Integração

A integração entre Magento e Shipay permite que lojistas aceitem pagamentos via Pix e carteiras digitais de forma simples e segura. Este guia apresenta o processo completo, desde o cadastro na Shipay até as configurações finais no Magento.

Recomendações Iniciais

• Ambiente de teste: Realize todas as validações em um ambiente de testes antes de aplicar mudanças na loja em produção.

• Backup da loja: Garanta um backup completo da sua loja Magento.

• Compatibilidade:

  • Magento: 2.4.6 ou superior.

  • PHP: Versão 8.1 ou 8.2.

1. Cadastro na Shipay

Para utilizar a Shipay no Magento, é necessário possuir um cadastro de loja no painel Shipay.

2. Instalação do Módulo Shipay no Magento

Pré-requisitos técnicos:

• Credenciais fornecidas pela Shipay.

• Acesso ao painel administrativo do Magento.

• Arquivo do módulo Shipay baixado.

1. Baixe o módulo:

Para baixar o modulo da Magento, basta acessar o link.

2. Envie o módulo para o Magento:

   • Acesse o painel administrativo do Magento.

   • Vá em Sistema > Ferramentas > Extensões Personalizadas.

   • Clique em Fazer Upload de Pacote.

   • Selecione o arquivo ZIP do módulo Shipay baixado e clique em Enviar.

3. Instale e habilite o módulo:

   • Após o upload, confirme a instalação.

   • Limpe o cache em Sistema > Gerenciar Cache.

   • Reindexe os dados em Sistema > Gerenciar Índices.

3. Configuração do Módulo Shipay

Após instalar o módulo, você deve configurar as opções de pagamento e credenciais.

3.1. Configuração de Pagamentos

1. No painel administrativo do Magento, acesse:

Sistema > Configuração > Formas de Pagamento.

2. Localize a seção Shipay - Pagamentos e configure os seguintes campos:

Ativado: Selecione "Sim" para habilitar o módulo.

Ambiente: Escolha:

• Sandbox: Ambiente de testes.

• Produção: Ambiente de uso real.

Título: Nome que aparecerá no checkout (ex.: "Pagamento via Pix e Carteiras Digitais").

Capturar documento CPF/CNPJ: Selecione:

• "Sim": Obriga o cliente a inserir CPF ou CNPJ no checkout.

• "Não": Não exige esse preenchimento.

Configurar tempo de expiração do Pix: Defina o tempo de expiração do pagamento em segundos (ex.: 86400 para 24 horas).

Debug:

• "Sim": Armazena logs no arquivo "shipay.log".

• "Não": Desativa o registro de logs.

Campo CPF/CNPJ obrigatório (caso selecionado “Não” no campo anterior):

• Vá para Sistema > Configuração > Clientes > Configurações > Exibir CPF/CNPJ.

• Configure este campo como obrigatório.

4. Configuração de Credenciais

1. No painel administrativo do Magento, acesse:

Sistema > Configuração > Formas de Pagamento > Shipay - Chaves de Acesso.

2. Preencha os seguintes campos com as credenciais fornecidas pela Shipay:

   • Access Key do Cliente

   • Secret Key do Cliente

   • Client ID do Caixa

   • Access Key do Sistema de PDV

   • ID do Sistema de PDV

Nota: As credenciais podem ser encontradas no painel Shipay:

• Acesse Painel Shipay > Aba Lojas > Nome da Loja > Credenciais.

5. Configuração do Token Shipay

Para reduzir a necessidade de reautenticação constante:

1. Vá para Sistema > Cache Management.

2. Certifique-se de que o cache "Shipay" está habilitado.

6. Personalizações Adicionais

6.1. No Frontend (Experiência do Cliente)

• Os clientes poderão visualizar no checkout:

  • Botão "Link para pagamento".

  • Botão "Abrir QR Code".

6.2. No Painel Administrativo

• Foi adicionada uma nova seção chamada "Detalhes do pagamento" no painel de visualização de pedidos.

6.3. Página de Sucesso

• Após a finalização da compra, o cliente verá:

  • Um QR Code para pagamento.

  • Botões para imprimir ou visualizar detalhes do pedido.

_____________________________________________________________________
Caso tenha alguma dúvida basta chamar o Suporte Shipay. 

Canais oficiais de atendimento:

ajuda@shipay.com.br

+55 11 94941-8625

Estamos à disposição!