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

# Configurando o PayPal

> Conecte sua conta do PayPal para receber pagamentos no seu app. Adicione o checkout do PayPal pelo chat de IA, teste-o e acompanhe pagamentos, reembolsos e assinaturas em um só lugar.

O PayPal é um provedor de pagamento integrado que permite que seus clientes paguem com PayPal sem sair do seu app. Você conecta sua própria conta do PayPal, então os pagamentos vão direto para ela.

A configuração do PayPal tem 4 etapas. Você conecta sua conta do PayPal, confere se o PayPal está pronto, adiciona o checkout com o chat de IA e faz um pagamento de teste.

Você pode vender compras únicas, carrinhos com vários produtos, produtos físicos com envio e assinaturas. Você também acompanha cada pagamento, reembolso e assinatura pelo painel do seu app.

![Uma captura de tela da página de checkout de um app com dados de entrega, um resumo do pedido e um botão Pay with PayPal](https://mintcdn.com/base44/IMwYFXZrPuumVGEc/images/apps-paypal-checkout-hero.png?fit=max\&auto=format\&n=IMwYFXZrPuumVGEc\&q=85\&s=0d00e31f0a66ca20344642f0073ce713)

Checkout do PayPal no seu app

> [!WARNING]
>
> **Antes de configurar o PayPal:**
>
> * **País:** Você pode usar o PayPal onde quer que o PayPal permita que vendedores recebam pagamentos. O PayPal verifica o país do seu negócio quando você se cadastra.
> * **Um provedor por app:** Você não pode conectar o PayPal a um app que já recebe pagamentos pela Base44 Payments, pelo Stripe, por uma loja Wix ou por uma loja Shopify. Para mudar para o PayPal, desconecte primeiro seu provedor atual. Se seu negócio está nos Estados Unidos, a Base44 Payments já permite que seus clientes paguem com PayPal.

***

## Etapa 1 | Conecte o PayPal

Conecte o PayPal pelo chat de IA ou pela página Integrações no painel do seu app. De qualquer forma, a Base44 leva você ao PayPal para entrar ou criar uma conta e depois traz você de volta à página Integrações do seu app quando você terminar. Quando o PayPal estiver pronto para receber pagamentos, uma mensagem no chat de IA avisa que o PayPal agora está conectado ao seu app.

> [!TIP]
>
> **Antes de conectar o PayPal:**
>
> * **Conta do PayPal:** Tenha seu login do PayPal em mãos, ou esteja pronto para criar uma conta do PayPal durante o cadastro.
> * **Pagamentos com cartão:** Para aceitar pagamentos com cartão além do PayPal, você precisa de uma conta empresarial do PayPal.

**Para conectar o PayPal:**

1. Acesse o editor do seu app.
2. Faça uma das seguintes ações:

> [accordion] Conectar pelo chat de IA
>
> 1. Peça à IA para adicionar pagamentos com PayPal ao seu app. Por exemplo:
>
>    ```text theme={null}
>    Adicione pagamentos com PayPal ao meu app para que os clientes possam pagar no checkout.
>    ```
>
> 2. No cartão **Connect to PayPal** no chat de IA, clique em **Conectar**.
>
> 3. Entre no PayPal, ou crie uma conta, e siga as etapas do PayPal para concluir o cadastro.
>
> 4. Quando o PayPal trouxer você de volta à página Integrações, volte ao chat de IA. Quando o PayPal estiver pronto, o chat mostra que o PayPal agora está conectado ao seu app, e você pode adicionar o checkout na Etapa 3.

> [accordion] Conectar pela página Integrações
>
> 1. Clique em **Painel**.
>
> 2. Clique em **Integrações**.
>
> 3. Clique em **Adicionar conector**.
>
> 4. Pesquise PayPal e clique em **PayPal**.
>
> 5. Clique em **Conectar**.
>
>    ![Uma captura de tela da janela de conexão do PayPal mostrando o PayPal como Not connected, com o botão Connect destacado](https://mintcdn.com/base44/IMwYFXZrPuumVGEc/images/apps-paypal-connect-dialog.png?fit=max\&auto=format\&n=IMwYFXZrPuumVGEc\&q=85\&s=ffe4d5b784219ca544f9e79e6efdeaa6)
>
>    Conectando sua conta do PayPal
>
> 6. Entre no PayPal, ou crie uma conta, e siga as etapas do PayPal para concluir o cadastro.

> [!TIP]
>
> Se você clicar em **Rejeitar** no cartão **Connect to PayPal**, a IA ainda cria seus produtos e sua página de checkout, e a página de checkout mostra que o PayPal está sendo configurado. Você pode conectar o PayPal depois pela página Integrações.

***

## Etapa 2 | Confira seu status

Para ver se seu app já pode receber pagamentos com PayPal, clique em **Integrações** no painel do seu app e confira a mensagem abaixo de **PayPal**. Quando estiver no ar, você também vê seu ID de comerciante do PayPal, para saber em qual conta do PayPal um app recebe os pagamentos.

![Uma captura de tela do item PayPal na página Integrations, com a mensagem de status Finish signing in to PayPal destacada](https://mintcdn.com/base44/IMwYFXZrPuumVGEc/images/apps-paypal-integrations-status.png?fit=max\&auto=format\&n=IMwYFXZrPuumVGEc\&q=85\&s=90a303e6c640d1925a6db3c376ed4936)

Conferindo o status do PayPal na página Integrações

A mensagem abaixo de **PayPal** diz o que fazer em seguida, se houver algo:

| O que você vê | O que fazer |
| - | - |
| Finish signing in to PayPal to start accepting payments | Você começou o cadastro no PayPal, mas não o concluiu. Clique em **Concluir configuração** para continuar. |
| Confirm your email address in PayPal to finish setup | Abra o e-mail que o PayPal enviou e confirme seu endereço. |
| PayPal is still reviewing your account | Nada. O PayPal está verificando sua conta, e a mensagem é atualizada quando terminar. |
| PayPal didn't grant all the permissions needed to take payments. Reconnect and approve them. | Clique em **Concluir configuração** e aprove todas as permissões que o PayPal pedir. |
| Access was revoked in PayPal. Reconnect to accept payments again. | A Base44 não tem mais acesso à sua conta do PayPal, por exemplo porque você a removeu no PayPal. Clique em **Concluir configuração** para conectar de novo. |
| Accepting PayPal payments. Upgrade to a business account in PayPal to accept cards. | Seus clientes podem pagar com PayPal. Para aceitar cartões também, faça upgrade para uma conta empresarial no PayPal. |
| Accepting payments | Nada. Seu app está pronto para receber pagamentos. |

> [!NOTE]
>
> O PayPal pode precisar que você conclua uma etapa do lado dele primeiro. A mensagem abaixo de **PayPal** é atualizada automaticamente quando você fizer isso.

***

## Etapa 3 | Adicione o checkout

Depois que o PayPal estiver conectado, peça ao chat de IA para adicionar o checkout do PayPal. Seus clientes clicam no botão do PayPal na sua página de checkout e aprovam o pagamento com o PayPal, sem sair do seu app. Se sua conta do PayPal aceitar cartões, seus clientes também podem pagar com cartão. Você não precisa colar nenhuma chave do PayPal no chat.

> [!WARNING]
>
> Seu checkout usa sua conta real do PayPal tanto na prévia quanto no app publicado, então todo pagamento feito ali é real.

Você precisa desta etapa mesmo se conectou o PayPal pelo chat de IA, porque a IA só adiciona o checkout depois que o PayPal está conectado. Se o PayPal ainda não estiver conectado, o chat de IA mostra primeiro o cartão **Connect to PayPal**. Clique em **Conectar**, conclua o cadastro no PayPal, volte ao chat de IA e peça para ele ligar seu checkout ao PayPal.

**Para adicionar o checkout do PayPal:**

1. Acesse o editor do seu app.
2. Descreva no chat de IA o que você vende e como os clientes devem pagar. Por exemplo:
   ```text theme={null}
   Adicione o checkout do PayPal ao meu app. Permita que os clientes reservem um pacote de viagem com um pagamento único e ofereça um plano Premium mensal como assinatura. Depois que alguém pagar, salve a reserva ou o plano na conta da pessoa e mostre uma página de confirmação.
   ```

> [!TIP]
>
> Se seu checkout coleta um endereço de entrega e o PayPal não conseguir aceitá-lo, seu checkout informa ao cliente qual campo corrigir, como um código postal ausente.

***

## Etapa 4 | Faça um pagamento de teste

Confira se sua conta do PayPal recebe pagamentos pagando um pedido de teste de US\$ 1 na página de checkout do PayPal. Você precisa de outra conta do PayPal ou de um cartão, porque o PayPal não permite que você pague para a conta que conectou. É um pagamento real, e você pode [reembolsá-lo](#tracking-and-refunding-payments) depois.

Se você preferir não fazer um pagamento, a IA pode verificar seu checkout para você. Abra a página Pagamentos no painel do seu app e clique em **Analisar** em **Peça ao builder para verificar**. A IA revisa seus produtos, seu checkout e o que acontece depois de um pagamento, e corrige qualquer coisa que impediria um cliente de pagar.

![Uma captura de tela de Ask the builder to check it na aba Payments, com o botão Review destacado](https://mintcdn.com/base44/IMwYFXZrPuumVGEc/images/apps-paypal-ask-builder.png?fit=max\&auto=format\&n=IMwYFXZrPuumVGEc\&q=85\&s=ba992bbc4a46fdce0df7df52a4d7cfd9)

Pedindo à IA para verificar seu checkout

**Para fazer um pagamento de teste:**

1. Acesse o editor do seu app.
2. Clique em **Painel**.
3. Clique em **Pagamentos**.
4. Em **Faça uma compra de teste**, clique em **Test with \$1**.
5. Pague com outra conta do PayPal ou com um cartão.

***

## Acompanhando e reembolsando pagamentos

Seus pagamentos do PayPal aparecem na aba Payments do painel do seu app, com sua receita, suas transações e suas assinaturas. Você gerencia disputas, repasses e recibos na sua conta do PayPal, que pode abrir pelo link **PayPal account** acima das suas transações na aba Payments. Veja [Acompanhando pagamentos no seu app](https://docs.base44.com/pt-BR/Setting-up-your-app/tracking-payments.md).

A Base44 não cobra taxa sobre pagamentos com PayPal. O PayPal cobra as taxas padrão dele e pode ficar com a taxa quando você reembolsa um pagamento.

> [!NOTE]
>
> Se você é novo nas vendas com PayPal, o PayPal pode reter alguns dos seus primeiros pagamentos por até 21 dias antes que você possa usá-los.

Você pode reembolsar um pagamento inteiro ou parte dele pela página de detalhes.

**Para reembolsar um pagamento:**

1. Acesse o editor do seu app.
2. Clique em **Painel**.
3. Clique em **Pagamentos**.
4. Clique em **Transações**.
5. Clique no pagamento que você quer reembolsar.
6. Clique em **Reembolsar**.
7. Digite o valor a reembolsar. Ele pode ser menor que o pagamento completo.
8. Clique em **Reembolsar** e depois em **Sim, reembolsar** para confirmar.

![Uma captura de tela da janela Refund payment com o botão Refund destacado](https://mintcdn.com/base44/IMwYFXZrPuumVGEc/images/apps-paypal-refund-window.png?fit=max\&auto=format\&n=IMwYFXZrPuumVGEc\&q=85\&s=a4912f6c17125faa4c4c71d2bda3eaa0)

A janela de reembolso do pagamento

> [!TIP]
>
> Você também pode pedir ao chat de IA para adicionar um botão de reembolso a uma página de administração do seu app. Assim, você reembolsa clientes sem abrir seu painel. A mesma página de administração também pode [gerenciar suas assinaturas](#managing-subscriptions).

***

## Gerenciando assinaturas

Com as assinaturas do PayPal, você pode cancelar, pausar ou retomar o plano de um cliente pelo seu app. Peça ao chat de IA para adicionar essas ações a uma página de administração, e ele configura seu app para lidar com cada uma. Por exemplo:

```text theme={null}
Adicione uma página de administração que liste todas as assinaturas. Permita que eu cancele, pause ou retome o plano de um cliente e reembolse o último pagamento dele.
```

Veja o que cada ação faz com o acesso do seu cliente:

* **Cancelar:** O PayPal encerra o plano na hora, então ele aparece como Cancelada, não como Cancelando, na sua aba Subscriptions. Seu cliente mantém o acesso até o fim do período que já pagou.
* **Pausar:** A cobrança para, e seu cliente perde o acesso enquanto o plano está pausado.
* **Retomar:** O plano fica ativo de novo, e seu cliente tem acesso enquanto o plano estiver pago.
* **Reembolsar:** Um reembolso total do último pagamento da assinatura encerra o acesso do seu cliente. Um reembolso parcial mantém o plano dele ativo.

Um plano com teste gratuito mantém o teste, então seu cliente não é cobrado até o fim do teste.

Se você reembolsar ou cancelar uma assinatura na sua conta do PayPal, ou se um pagamento de renovação falhar, seu app remove o acesso do cliente automaticamente.

> [!TIP]
>
> Crie um workflow com o gatilho **Assinatura cancelada** para agir quando um plano terminar, por exemplo para enviar um e-mail ao cliente ou atualizar a conta dele. Ele é executado quando uma assinatura é cancelada, expira ou é pausada. Saiba mais sobre [workflows de pagamentos do app](https://docs.base44.com/pt-BR/Building-your-app/Creating-workflows.md#app-payment).

***

## Desconectando o PayPal

Desconectar o PayPal faz seu app parar de receber novos pagamentos na hora. Suas transações anteriores continuam nos seus registros.

> [!WARNING]
>
> As assinaturas dos seus clientes continuam sendo cobradas no PayPal até você cancelá-las na sua conta do PayPal. Depois de desconectar, você não pode reembolsar pagamentos pela Base44, então faça os reembolsos antes.

**Para desconectar o PayPal:**

1. Acesse o editor do seu app.
2. Clique em **Painel**.
3. Clique em **Integrações**.
4. Clique no ícone **Mais ações**  ao lado de **PayPal**.
5. Clique em **Desconectar**.

***

## Solução de problemas

Se o PayPal não estiver funcionando como esperado, encontre sua situação abaixo.

> [accordion] Meu cadastro no PayPal não funcionou
>
> O PayPal pode não permitir que vendedores no país do seu negócio recebam pagamentos. Nesse caso, você pode receber pagamentos com a [Base44 Payments](https://docs.base44.com/pt-BR/Setting-up-your-app/setting-up-wix-payments.md) ou com o [Stripe](https://docs.base44.com/pt-BR/documentation/setting-up-your-app/setting-up-payments.md).

> [accordion] O PayPal diz que meu app já recebe pagamentos
>
> Seu app já recebe pagamentos por outro provedor ou por uma loja, e cada app pode usar só 1. Desconecte seu provedor atual e depois conecte o PayPal.

> [accordion] Meu checkout diz que o PayPal está sendo configurado
>
> Seu checkout espera até que o PayPal esteja conectado e pronto. Confira a mensagem abaixo de **PayPal** na página Integrações, conclua qualquer etapa que ela pedir e peça ao chat de IA para terminar seu checkout do PayPal.

> [!NOTE]
>
> Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](https://docs.base44.com/index.md).


## Related topics

- [Configurando Base44 Payments alimentado pela Wix](https://docs.base44.com/pt-BR/Setting-up-your-app/setting-up-wix-payments.md)
- [Rastreando pagamentos no seu app](https://docs.base44.com/pt-BR/Setting-up-your-app/tracking-payments.md)
- [Configurando o Stripe](https://docs.base44.com/pt-BR/documentation/setting-up-your-app/setting-up-payments.md)
- [Criando workflows para seu aplicativo](https://docs.base44.com/pt-BR/Building-your-app/Creating-workflows.md)
- [Faturamento e planos](https://docs.base44.com/pt-BR/Account-and-billing/Billing-and-plans.md)


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