> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumi.new/llms.txt
> Use this file to discover all available pages before exploring further.

# PayPal

> Aceite pagamentos e subscrições PayPal no seu site.

Pode configurar pagamentos PayPal inteiramente através do chat do Lumi. Indique PayPal no seu pedido e descreva o que pretende vender:

* "Let people pay for my e-book with PayPal, \$15 one-time."
* "Add a \$9.99/month membership billed through PayPal."

Com as credenciais da sua aplicação PayPal, o Lumi trabalha diretamente na sua conta empresarial PayPal e constrói todo o fluxo de pagamento no seu site:

* **Pagamentos únicos**: um botão PayPal que leva o comprador ao PayPal para aprovar o pagamento e depois regista o pagamento concluído na sua base de dados.
* **Subscrições**: o Lumi cria o produto e o plano de subscrição na sua conta PayPal (reutilizando os existentes com o mesmo nome e preço), adiciona um botão de subscrição e mantém atualizado o estado de cada subscrição.
* **Webhook**: o Lumi regista um webhook para que o seu site seja notificado quando os pagamentos são concluídos ou reembolsados, ou quando as subscrições são ativadas, canceladas, suspensas ou não são renovadas.
* **Página de preços e acesso condicionado**: o conteúdo pago só é mostrado aos clientes que pagaram.

Também pode, a qualquer momento, fazer perguntas ao Lumi sobre a sua conta PayPal, por exemplo "Show my recent transactions," "List my subscription plans," "Refund this order," ou "Cancel this subscription."

> [!NOTE]
>
> O PayPal está disponível para projetos web. Se não indicar um fornecedor de pagamentos, o Lumi usa o [Stripe](https://docs.lumi.new/pt/features/stripe.md).

## Ligue as suas credenciais PayPal

**1. Crie uma aplicação REST no PayPal**

No PayPal Developer Dashboard, vá a **Apps & Credentials** e crie ou abra uma aplicação REST. Use o separador **Sandbox** para testes, ou o separador **Live** para pagamentos reais. Copie o **Client ID** e a **Secret key** da aplicação.

**2. Introduza as credenciais no Lumi**

Preencha o cartão de credenciais PayPal que o Lumi mostra no chat, ou abra o separador **Ferramentas** no seu espaço de trabalho e clique no cartão **PayPal**. Introduza o **PayPal client ID** e o **PayPal client secret**, escolha o **Environment** (**Sandbox (testes)** ou **Produção**) e depois clique em **Guardar** e **Verificar**.

> [!WARNING]
>
> Nunca cole as suas credenciais numa mensagem do chat. São guardadas em segurança nos [Segredos](https://docs.lumi.new/pt/features/secrets.md) do seu projeto. As credenciais de Sandbox só funcionam com o ambiente Sandbox, e as credenciais Live só com o ambiente de produção. Esta incompatibilidade é o motivo mais comum para o PayPal rejeitar as credenciais.

### Controle o que o Lumi pode alterar

No cartão **PayPal** do separador Ferramentas, cada ação que altera a sua conta PayPal tem uma definição de aprovação: **Permitir sempre**, **Perguntar de cada vez** ou **Nunca permitir**. Por predefinição, criar produtos e planos é permitido, enquanto os **reembolsos** e o **cancelamento de subscrições** pedem a sua aprovação de cada vez. As ações só de leitura, como listar transações, são sempre permitidas.

## Testar e entrar em produção

**1. Teste na sandbox**

Com credenciais de Sandbox, não há movimentação de dinheiro real. Na página do PayPal, inicie sessão com uma conta de comprador de sandbox (PayPal Developer Dashboard → **Testing Tools** → **Sandbox Accounts** → o e-mail e a palavra-passe de uma conta Personal). Depois de pagar, verifique se o registo do pagamento ou da subscrição aparece em [Nuvem → Dados](https://docs.lumi.new/pt/features/databases.md) e se a sua página mostra a compra.

**2. Mude para produção**

Crie uma aplicação Live no PayPal e depois, no cartão **PayPal**, introduza o respetivo Client ID e Secret e defina o Environment como **Produção**. Peça ao Lumi que mude para produção: os produtos e planos da sandbox não são transferidos, por isso o Lumi volta a criá-los na sua conta de produção e regista novamente o webhook.

**3. Teste final e lançamento**

Teste mais uma vez com um artigo de preço baixo e depois publique o seu site e partilhe-o.

Se algo correr mal em qualquer passo, diga ao Lumi. Ele verifica a sua conta PayPal e os registos das suas funções para encontrar e corrigir o problema.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.