# 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.