PayPal — Configure o gateway de pagamento

Aceite pagamentos com saldo PayPal ou cartão, usando redirecionamento ou uma experiência integrada à página da loja.

Para que serve este módulo?

A integração com PayPal adiciona uma forma de pagamento ao checkout. A loja utiliza as credenciais do aplicativo PayPal para criar e confirmar pagamentos com segurança.

1 - Pré-requisitos

• Conta comercial PayPal apta a receber pagamentos.
• Aplicativo REST criado no PayPal Developer Dashboard.
• Client ID e Client Secret do ambiente Live.
• Permissão para editar Formas de Pagamento.

2 - Criando o aplicativo no PayPal

1. Acesse o PayPal Developer Dashboard com a conta da empresa.
2. Abra a área de aplicativos e crie um aplicativo REST.
3. Selecione o ambiente de produção para obter as credenciais Live.
4. Copie o Client ID e o Client Secret.

Não envie o Client Secret por mensagens, e-mail ou capturas de tela.

3 - Configurando na loja

1. Acesse Configurações > Formas de Pagamento > PayPal.
2. Cole o Client ID e o Client Secret nos campos de produção.
3. Escolha o estilo do checkout.
4. Defina valores mínimo e máximo, se desejar.
5. Mantenha o módulo inativo enquanto conclui o webhook e os testes.
6. Salve as configurações.

4 - Escolhendo o estilo do checkout

Padrão

O cliente é direcionado ao PayPal para aprovar o pagamento e retorna à loja ao finalizar.

Transparente

O botão PayPal aparece na página da loja e abre a aprovação sobre o checkout, sem trocar a página principal.

5 - Configurando o webhook

1. Copie a URL do Webhook exibida na configuração.
2. No aplicativo PayPal, crie um webhook usando essa URL.
3. Marque eventos de aprovação/conclusão do pedido e captura concluída, negada, reembolsada ou pendente.
4. Copie o Webhook ID gerado e cole na loja.
5. Salve novamente.

O Webhook ID permite verificar se as notificações realmente foram enviadas pelo PayPal.

6 - Ativação e teste

1. Revise credenciais, webhook, estilo e limites de valor.
2. Ative o módulo e salve.
3. Faça um pedido de teste de baixo valor.
4. Confirme retorno para a loja e atualização do pagamento no painel.
5. Verifique também cancelamento e tentativa negada.

O ambiente Sandbox pode estar disponível apenas em ambientes autorizados da plataforma. Na loja em produção, utilize credenciais Live.

7 - Problemas comuns

PayPal não aparece no checkout

Confira se o módulo está ativo e se o valor do pedido respeita os limites configurados.

Credenciais inválidas

Confirme que Client ID e Secret pertencem ao mesmo aplicativo e ao ambiente correto.

Pagamento aprovado não atualizou

Revise URL, eventos e Webhook ID. Consulte também o pagamento no painel antes de alterar o status manualmente.

Atenção: Nunca publique ou compartilhe o Client Secret. Se houver suspeita de exposição, gere uma nova credencial no PayPal e atualize imediatamente a configuração da loja.