> ## 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 assinaturas do PayPal no seu site.

Você pode configurar pagamentos do PayPal inteiramente pelo chat do Lumi. Cite o PayPal no seu pedido e descreva o que você quer 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 do seu app do PayPal, o Lumi trabalha diretamente na sua conta empresarial do PayPal e cria todo o fluxo de pagamento no seu site:

* **Pagamentos únicos**: um botão do PayPal que leva o comprador ao PayPal para aprovar o pagamento e depois registra o pagamento concluído no seu banco de dados.
* **Assinaturas**: o Lumi cria o produto e o plano de assinatura na sua conta do PayPal (reaproveitando os existentes com o mesmo nome e preço), adiciona um botão de assinatura e mantém o status de cada assinatura atualizado.
* **Webhook**: o Lumi registra um webhook para que o seu site seja avisado quando pagamentos forem concluídos ou reembolsados, ou quando assinaturas forem ativadas, canceladas, suspensas ou não puderem ser renovadas.
* **Página de preços e controle de acesso**: o conteúdo pago só é exibido para os clientes que pagaram.

Você também pode perguntar ao Lumi sobre a sua conta do PayPal a qualquer momento, 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 você não indicar um provedor de pagamento, o Lumi usa a [Stripe](https://docs.lumi.new/pt-BR/features/stripe.md).

## Conecte as suas credenciais do PayPal

**1. Crie um app REST no PayPal**

No PayPal Developer Dashboard, vá em **Apps & Credentials** e crie ou abra um app REST. Use a aba **Sandbox** para testes ou a aba **Live** para pagamentos reais. Copie o **Client ID** e a **Secret key** do app.

**2. Informe as credenciais no Lumi**

Preencha o cartão de credenciais do PayPal que o Lumi mostra no chat, ou abra a aba **Ferramentas** no seu espaço de trabalho e clique no cartão **PayPal**. Informe o **PayPal client ID** e o **PayPal client secret**, escolha o **Ambiente** (**Sandbox (testes)** ou **Produção**) e depois clique em **Salvar** e **Verificar**.

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

### Controle o que o Lumi pode alterar

No cartão **PayPal** da aba Ferramentas, toda ação que altera a sua conta do PayPal tem uma configuração de aprovação: **Sempre permitir**, **Perguntar toda vez** ou **Nunca permitir**. Por padrão, criar produtos e planos é permitido, enquanto **reembolsos** e **cancelamentos de assinaturas** pedem a sua aprovação toda vez. Ações somente de leitura, como listar transações, são sempre permitidas.

## Teste e entre em produção

**1. Teste no sandbox**

Com credenciais de Sandbox, nenhum dinheiro real é movimentado. Na página do PayPal, entre com uma conta de comprador do sandbox (PayPal Developer Dashboard → **Testing Tools** → **Sandbox Accounts** → o e-mail e a senha de uma conta Personal). Depois de pagar, verifique se o registro do pagamento ou da assinatura aparece em [Nuvem → Dados](https://docs.lumi.new/pt-BR/features/databases.md) e se a sua página mostra a compra.

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

Crie um app Live no PayPal e, no cartão **PayPal**, informe o Client ID e o Secret dele e defina o Ambiente como **Produção**. Peça ao Lumi para mudar para produção: os produtos e planos do sandbox não são transferidos, então o Lumi os recria na sua conta de produção e registra o webhook novamente.

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

Teste mais uma vez com um item de preço baixo, depois publique o seu site e compartilhe.

Se algo der errado em qualquer etapa, avise o Lumi. Ele verifica a sua conta do PayPal e os logs 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.