Se você está iniciando uma instalação do Magento, é recomendado fazer o download da última versão da plataforma, que pode ser encontrada em: http://www.magentocommerce.com/download. Após fazer o download, prossiga para o passo 2.

Caso você já possua uma instalação do Magento, pode ser necessário fazer uma atualização no sistema para que funcione adequadamente com o PayPal com as configurações no Brasil.

Passo 1 Aplicando patches no Magento:

A plataforma Magento, sempre que um ajuste é feito a nível de sistema, disponibiliza um arquivo com a extensão .patch, esses arquivos possuem uma série de correções em diversos arquivos da aplicação.

Existem alguns patches que devem ser aplicados às versões anteriores do Magento para que ele funcione adequadamente com as configurações no Brasil. Esses três patches estão disponíveis para download aqui mesmo nesse tutorial. Para aplicá-los você deve:

1. 1.1 Fazer backup da sua instalação atual do Magento
2. 1.2 Fazer backup do seu banco de dados
3. 1.3 Copiar o arquivo .patch ao diretório raiz do Magento

   Caso você possua acesso SSH ao servidor onde está a instalação da plataforma Magento, você deve copiar os arquivos .patch diretamente ao diretório raiz do seu servidor.

   Caso não possua acesso SSH, você deverá ter uma cópia dos arquivos da aplicação e, se ainda não tiver esses arquivos em sua máquina, acesse o FTP e faça download deles.

   Após ter todos os arquivos da instalação Magento na sua máquina local, copie os arquivos .patch para o diretório onde estão os arquivos locais.

4. 1.4 No seu terminal ou prompt de comando, vá até o diretório raiz do Magento e execute o seguinte:

   
patch -p0 < [patch_file_name]


   Onde [patch_file_name] deve ser substituído pelo nome completo do arquivo .patch.

5. 1.5 Caso você não tenha acesso SSH e tenha feito o download dos arquivos, você deverá fazer o caminho inverso, dessa vez fazendo o upload dos arquivos locais de volta ao servidor
6. 1.6 No administrador da plataforma Magento atualize o cache.
7. 1.7 Se sua versão do Magento for antiga, atualize os índices

Passo 2 Configurar uma conta no PayPal SandBox:

A configuração da conta no PayPal SandBox é importante pois, através dela, conseguiremos testar a integração antes de colocá-la em produção.

Para fazer a configuração do PayPal SandBox você deve seguir o seguinte tutorial: Usando o SandBox PayPal

Passo 3 Configurar o Magento para trabalhar com PayPal:

Nesse momento já estamos com a plataforma Magento atualizada e com uma conta no PayPal SandBox configurada. Vamos até a área administrativa do Magento e fazer login:

Em seguida, no menu principal, vamos até System e então em Configuration:

Na tela de configurações, vamos até o menu lateral e no grupo Sales e clicamos em PayPal:

Na tela que se abre, vamos configurar a conta PayPal:

Em "Merchant Country", definimos Brasil e no campo "Email Associated with PayPal Merchant Account" colocamos o email da conta PayPal.

Em seguida, em "Select a PayPal Solution", vamos escolher "Express Checkout":

Cada um dos campos de configuração é descrito abaixo:

1. Title Esse é o nome da opção de pagamento que aparecerá ao cliente da loja. É recomendado que seja utilizado o nome PayPal para fácil identificação da solução de pagamento pelo cliente.
2. Sort Order Quando várias formas de pagamento são utilizadas na loja, esse campo servirá para definir a ordem em que eles aparecerão.
3. Payment Action Esse campo define a forma com que os pagamentos serão autorizados no PayPal e como o Magento trabalhará com eles. As opções disponíveis são:
   • Authorization Com essa opção, os pagamentos são apenas autorizados no lado do PayPal e apenas uma ordem de compra é criada no sistema. O administrador da loja precisará fazer login na sua conta do PayPal e capturar a transação.
   • Sale Com essa opção, os pagamentos são autorizados e capturados no lado do PayPal e no Magento uma ordem de compra e um pedido são criados no sistema.
4. Payment Applicable From Esse campo define os países em que os clientes poderão utilizar essa forma de pagamento, as duas opções disponíveis são:
   • All Allowed Countries Clientes da lista padrão de países poderão utilizar esse meio de pagamento. Essa lista pode ser configurada em "System"/"Configuration"/"General"/"Countries Options".
   • Specific Countries Apenas clientes que forem dos países definidos na lista que se abre logo na escolha desse campo.
5. Debug Mode Esse campo define se dados sobre todos os pagamentos e informações recebidas deverão ser gravadas em um arquivo de log. Apenas as informações sobre cartão de crédito não são gravadas para evitar riscos de fraude.
6. Transfer Cart Line Items Esse campo define se os itens do carrinho do cliente será enviado separadamente, item por item e seus preços ou se serão agrupados em um único item, com o valor total. Definindo esse campo, o campo "Transfer Shipping Options" passará a estar disponível.
7. Transfer Shipping Options Esse campo define se os clientes poderão modificar seu endereço e método de entrega quando estiverem no site do PayPal. No ambiente de produção, esse campo só funcionará via HTTPS e se não houver mais do que 10 opções de entrega disponíveis.
8. Shortcut on Shopping Cart Esse campo define se o cliente poderá usar o botão do Express Checkout na página do carrinho. Para se compreender melhor o Shortcut, temos um artigo explicando o que é: Colocando a opção de pagamento antes do cadastro do cliente
9. Shortcut on Product View Esse campo define se o botão do Express Checkout aparecerá na página de visualização do produto
10. Shortcut Buttons Flavor Esse campo define se as imagens da marca PayPal serão exibidas de forma estática ou dinâmica. É recomendado que a opção "dynamic" seja escolhida para facilitar o gerenciamento dessas imagens.
    • Dynamic As imagens são modificadas dinamicamente pelo PayPal
    • Static As imagens são estáticas, ou seja, sempre que for necessário modificá-las, esse processo será feito manualmente
11. Enable PayPal Guest Checkout Se esse campo for habilitado, clientes que não possuem conta no PayPal poderão efetuar pagamentos sem fazer um cadastro no PayPal. No caso do cliente não ter conta no PayPal, ele poderá informar no ambiente seguro do PayPal seu número de cartão, que será validado e processado pelo PayPal e, somente então, o cliente poderá revisar as informações e efetuar o pagamento. Se esse campo não estiver habilitado, o cliente precisará ter uma conta no PayPal ou fazer um cadastro na hora do pagamento.

Passo 4 Configurando a autenticação no PayPal:

Definidos os campos de configuração do Express Checkout, as informações da API deverão ser informadas:

O campo "API Authentication Methods" define a forma que será utilizada para fazer a autenticação no PayPal, as opções são:

• API Signature Para obter uma assinatura de API, você pode ler esse artigo: Gerar as credenciais da API
• API Certificate Para obter um certificado para a API, você pode ler esse artigo: Solicitação de um certificado de API

Durante os testes, o campo "Sandbox Mode" deve ser definido como "Yes", quando tudo estiver funcionando corretamente, esse campo deve ser ajustado como "No".

Ao mudar para produção (Sandbox Mode = No), não se esqueça de gerar uma nova chave de API ou certificado de API no ambiente de produção.