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

# Configurare PayPal

> Collega il tuo account PayPal per ricevere pagamenti nella tua app. Aggiungi il checkout PayPal dalla chat AI, testalo, poi monitora pagamenti, rimborsi e abbonamenti in un unico posto.

PayPal è un fornitore di pagamenti integrato che permette ai tuoi clienti di pagare con PayPal senza uscire dalla tua app. Colleghi il tuo account PayPal, quindi i pagamenti arrivano direttamente lì.

La configurazione di PayPal richiede 4 passaggi. Colleghi il tuo account PayPal, controlli che PayPal sia pronto, aggiungi il checkout con la chat AI e poi fai un pagamento di prova.

Puoi vendere acquisti singoli, carrelli con più prodotti, beni fisici con spedizione e abbonamenti. Puoi monitorare ogni pagamento, rimborso e abbonamento dalla dashboard della tua app.

![Uno screenshot della pagina di checkout di un'app con i dati di consegna, il riepilogo dell'ordine e un pulsante Pay with PayPal](https://mintcdn.com/base44/IMwYFXZrPuumVGEc/images/apps-paypal-checkout-hero.png?fit=max\&auto=format\&n=IMwYFXZrPuumVGEc\&q=85\&s=0d00e31f0a66ca20344642f0073ce713)

Il checkout PayPal nella tua app

> [!WARNING]
>
> **Prima di configurare PayPal:**
>
> * **Paese:** puoi usare PayPal ovunque PayPal permetta ai venditori di ricevere pagamenti. PayPal controlla il paese della tua attività quando ti registri.
> * **Un fornitore per app:** non puoi collegare PayPal a un'app che riceve già pagamenti tramite Base44 Payments, Stripe, un negozio Wix o un negozio Shopify. Per passare a PayPal, scollega prima il fornitore attuale. Se la tua attività è negli Stati Uniti, Base44 Payments permette già ai tuoi clienti di pagare con PayPal.

***

## Passaggio 1 | Collegare PayPal

Collega PayPal dalla chat AI o dalla pagina Integrations nella dashboard della tua app. In entrambi i casi, Base44 ti porta su PayPal per accedere o creare un account. Al termine ti riporta alla pagina Integrations della tua app. Quando PayPal è pronto a ricevere pagamenti, un messaggio nella chat AI ti dice che PayPal è ora collegato alla tua app.

> [!TIP]
>
> **Prima di collegare PayPal:**
>
> * **Account PayPal:** tieni pronti i tuoi dati di accesso a PayPal, oppure preparati a creare un account PayPal durante la registrazione.
> * **Pagamenti con carta:** per accettare pagamenti con carta oltre a PayPal, ti serve un account PayPal business.

**Per collegare PayPal:**

1. Vai all'editor della tua app.
2. Esegui una delle seguenti operazioni:

> [accordion] Collegare dalla chat AI
>
> 1. Chiedi all'AI di aggiungere i pagamenti PayPal alla tua app. Per esempio:
>
>    ```text theme={null}
>    Aggiungi i pagamenti PayPal alla mia app così i clienti possono pagare al checkout.
>    ```
>
> 2. Nella scheda **Connect to PayPal** della chat AI, clicca **Connect**.
>
> 3. Accedi a PayPal, oppure crea un account, e segui i passaggi di PayPal per completare la registrazione.
>
> 4. Quando PayPal ti riporta alla pagina Integrations, torna alla chat AI. Quando PayPal è pronto, la chat mostra che PayPal è ora collegato alla tua app e puoi aggiungere il checkout nel passaggio 3.

> [accordion] Collegare dalla pagina Integrations
>
> 1. Clicca **Dashboard**.
>
> 2. Clicca **Integrations**.
>
> 3. Clicca **Add connector**.
>
> 4. Cerca PayPal e clicca **PayPal**.
>
> 5. Clicca **Connect**.
>
>    ![Uno screenshot della finestra di collegamento di PayPal che mostra PayPal come Not connected, con il pulsante Connect evidenziato](https://mintcdn.com/base44/IMwYFXZrPuumVGEc/images/apps-paypal-connect-dialog.png?fit=max\&auto=format\&n=IMwYFXZrPuumVGEc\&q=85\&s=ffe4d5b784219ca544f9e79e6efdeaa6)
>
>    Collegare il tuo account PayPal
>
> 6. Accedi a PayPal, oppure crea un account, e segui i passaggi di PayPal per completare la registrazione.

> [!TIP]
>
> Se clicchi **Reject** nella scheda **Connect to PayPal**, l'AI crea comunque i tuoi prodotti e la pagina di checkout, e la pagina di checkout mostra che PayPal è in fase di configurazione. Puoi collegare PayPal in seguito dalla pagina Integrations.

***

## Passaggio 2 | Controllare lo stato

Per vedere se la tua app può già ricevere pagamenti PayPal, clicca **Integrations** nella dashboard della tua app e controlla il messaggio sotto **PayPal**. Quando sei operativo, vedi anche il tuo merchant ID PayPal. Così puoi capire su quale account PayPal viene pagata un'app.

![Uno screenshot della voce PayPal nella pagina Integrations, con il messaggio di stato Finish signing in to PayPal evidenziato](https://mintcdn.com/base44/IMwYFXZrPuumVGEc/images/apps-paypal-integrations-status.png?fit=max\&auto=format\&n=IMwYFXZrPuumVGEc\&q=85\&s=90a303e6c640d1925a6db3c376ed4936)

Controllare lo stato di PayPal nella pagina Integrations

Il messaggio sotto **PayPal** ti dice cosa fare dopo, se serve:

| Cosa vedi | Cosa fare |
| - | - |
| Completa l'accesso a PayPal per iniziare ad accettare pagamenti | Hai iniziato la registrazione a PayPal ma non l'hai completata. Clicca **Finish setup** per continuare. |
| Conferma il tuo indirizzo email in PayPal per completare la configurazione | Apri l'email che PayPal ti ha inviato e conferma il tuo indirizzo. |
| PayPal sta ancora esaminando il tuo account | Niente. PayPal sta controllando il tuo account e il messaggio si aggiorna quando ha finito. |
| PayPal non ha concesso tutti i permessi necessari per ricevere pagamenti. Ricollegati e approvali. | Clicca **Finish setup** e approva ogni permesso richiesto da PayPal. |
| L'accesso è stato revocato in PayPal. Ricollegati per accettare di nuovo pagamenti. | Base44 non ha più accesso al tuo account PayPal, ad esempio perché l'hai rimosso in PayPal. Clicca **Finish setup** per ricollegarti. |
| Pagamenti PayPal accettati. Passa a un account business in PayPal per accettare le carte. | I tuoi clienti possono pagare con PayPal. Per accettare anche le carte, passa a un account business in PayPal. |
| Pagamenti accettati | Niente. La tua app è pronta a ricevere pagamenti. |

> [!NOTE]
>
> PayPal potrebbe chiederti di completare prima un passaggio dalla sua parte. Il messaggio sotto **PayPal** si aggiorna automaticamente quando lo fai.

***

## Passaggio 3 | Aggiungere il checkout

Una volta collegato PayPal, chiedi alla chat AI di aggiungere il checkout PayPal. I tuoi clienti cliccano il pulsante PayPal nella pagina di checkout e approvano il pagamento con PayPal, senza uscire dalla tua app. Se il tuo account PayPal accetta le carte, i tuoi clienti possono pagare anche con carta. Non devi incollare chiavi PayPal nella chat.

> [!WARNING]
>
> Il tuo checkout usa il tuo account PayPal live sia nell'anteprima sia nell'app pubblicata, quindi ogni pagamento fatto lì è reale.

Ti serve questo passaggio anche se hai collegato PayPal dalla chat AI, perché l'AI aggiunge il checkout solo quando PayPal è collegato. Se PayPal non è ancora collegato, la chat AI mostra prima la scheda **Connect to PayPal**. Clicca **Connect**, completa la registrazione con PayPal, poi torna alla chat AI e chiedile di collegare il checkout a PayPal.

**Per aggiungere il checkout PayPal:**

1. Vai all'editor della tua app.
2. Nella chat AI, descrivi cosa vendi e come devono pagare i clienti. Per esempio:
   ```text theme={null}
   Aggiungi il checkout PayPal alla mia app. Permetti ai clienti di prenotare un pacchetto viaggio con un pagamento unico e offri un piano Premium mensile come abbonamento. Dopo il pagamento, salva la prenotazione o il piano nel loro account e mostra una pagina di conferma.
   ```

> [!TIP]
>
> Se il tuo checkout raccoglie un indirizzo di spedizione e PayPal non riesce ad accettarlo, il checkout indica al cliente quale campo correggere, ad esempio un codice postale mancante.

***

## Passaggio 4 | Fare un pagamento di prova

Controlla che il tuo account PayPal riceva pagamenti pagando un ordine di prova da \$1 nella pagina di checkout di PayPal. Ti serve un altro account PayPal o una carta, perché PayPal non ti permette di pagare l'account che hai collegato. È un pagamento reale, e puoi [rimborsarlo](#tracking-and-refunding-payments) in seguito.

Se preferisci non fare un pagamento, l'AI può controllare il checkout per te. Apri la pagina Payments nella dashboard della tua app, poi clicca **Review** sotto **Ask the builder to check it**. L'AI esamina i tuoi prodotti, il checkout e cosa succede dopo un pagamento, e corregge tutto ciò che impedirebbe a un cliente di pagare.

![Uno screenshot di Ask the builder to check it nella scheda Payments, con il pulsante Review evidenziato](https://mintcdn.com/base44/IMwYFXZrPuumVGEc/images/apps-paypal-ask-builder.png?fit=max\&auto=format\&n=IMwYFXZrPuumVGEc\&q=85\&s=ba992bbc4a46fdce0df7df52a4d7cfd9)

Chiedere all'AI di controllare il checkout

**Per fare un pagamento di prova:**

1. Vai all'editor della tua app.
2. Clicca **Dashboard**.
3. Clicca **Payments**.
4. In **Make a test purchase**, clicca **Test with \$1**.
5. Paga con un altro account PayPal o con una carta.

***

## Monitorare e rimborsare i pagamenti

I tuoi pagamenti PayPal appaiono nella scheda Payments della dashboard della tua app, con entrate, transazioni e abbonamenti. Contestazioni, pagamenti in uscita e ricevute si gestiscono nel tuo account PayPal. Puoi aprirlo dal link **PayPal account** sopra le transazioni nella scheda Payments. Consulta [Monitorare i pagamenti nella tua app](https://docs.base44.com/it/Setting-up-your-app/tracking-payments.md).

Base44 non trattiene commissioni sui pagamenti PayPal. PayPal applica le sue commissioni standard e potrebbe trattenerle quando rimborsi un pagamento.

> [!NOTE]
>
> Se sei nuovo nella vendita con PayPal, PayPal potrebbe trattenere alcuni dei tuoi primi pagamenti per un massimo di 21 giorni prima che tu possa usarli.

Puoi rimborsare tutto o parte di un pagamento dalla sua pagina dei dettagli.

**Per rimborsare un pagamento:**

1. Vai all'editor della tua app.
2. Clicca **Dashboard**.
3. Clicca **Payments**.
4. Clicca **Transactions**.
5. Clicca il pagamento da rimborsare.
6. Clicca **Refund**.
7. Inserisci l'importo da rimborsare. Può essere inferiore al pagamento completo.
8. Clicca **Refund**, poi clicca **Yes, refund** per confermare.

![Uno screenshot della finestra Refund payment con il pulsante Refund evidenziato](https://mintcdn.com/base44/IMwYFXZrPuumVGEc/images/apps-paypal-refund-window.png?fit=max\&auto=format\&n=IMwYFXZrPuumVGEc\&q=85\&s=a4912f6c17125faa4c4c71d2bda3eaa0)

La finestra Refund payment

> [!TIP]
>
> Puoi anche chiedere alla chat AI di aggiungere un pulsante di rimborso a una pagina di amministrazione della tua app. Così puoi rimborsare i clienti senza aprire la dashboard. La stessa pagina di amministrazione può anche [gestire i tuoi abbonamenti](#managing-subscriptions).

***

## Gestire gli abbonamenti

Con gli abbonamenti PayPal, puoi annullare, mettere in pausa o riprendere il piano di un cliente dalla tua app. Chiedi alla chat AI di aggiungere queste azioni a una pagina di amministrazione, e configura la tua app per gestirle. Per esempio:

```text theme={null}
Aggiungi una pagina di amministrazione che elenca tutti gli abbonamenti. Permettimi di annullare, mettere in pausa o riprendere il piano di un cliente e di rimborsare il suo ultimo pagamento.
```

Ecco cosa fa ogni azione all'accesso del tuo cliente:

* **Annullare:** PayPal ferma subito il piano, quindi appare come Canceled, non Canceling, nella scheda Subscriptions. Il tuo cliente mantiene l'accesso fino alla fine del periodo già pagato.
* **Mettere in pausa:** la fatturazione si ferma e il tuo cliente perde l'accesso mentre il piano è in pausa.
* **Riprendere:** il piano torna attivo e il tuo cliente ha accesso finché il suo piano è pagato.
* **Rimborsare:** un rimborso completo dell'ultimo pagamento dell'abbonamento termina l'accesso del tuo cliente. Un rimborso parziale mantiene attivo il suo piano.

Un piano con una prova gratuita mantiene la prova, quindi il tuo cliente non paga finché la prova non termina.

Se rimborsi o annulli un abbonamento nel tuo account PayPal, o un pagamento di rinnovo non va a buon fine, la tua app rimuove automaticamente l'accesso del tuo cliente.

> [!TIP]
>
> Crea un workflow con il trigger **Subscription canceled** per agire quando un piano termina, ad esempio per inviare un'email al cliente o aggiornare il suo account. Viene eseguito quando un abbonamento viene annullato, scade o viene messo in pausa. Scopri di più sui [workflow dei pagamenti dell'app](https://docs.base44.com/it/Building-your-app/Creating-workflows.md#app-payment).

***

## Scollegare PayPal

Scollegare PayPal impedisce subito alla tua app di ricevere nuovi pagamenti. Le transazioni passate restano nei tuoi registri.

> [!WARNING]
>
> Gli abbonamenti dei tuoi clienti continuano a essere fatturati in PayPal finché non li annulli nel tuo account PayPal. Dopo aver scollegato PayPal, non puoi rimborsare pagamenti tramite Base44, quindi fai prima eventuali rimborsi.

**Per scollegare PayPal:**

1. Vai all'editor della tua app.
2. Clicca **Dashboard**.
3. Clicca **Integrations**.
4. Clicca l'icona **More actions**  accanto a **PayPal**.
5. Clicca **Disconnect**.

***

## Risoluzione dei problemi

Se PayPal non funziona come previsto, trova la tua situazione qui sotto.

> [accordion] La registrazione a PayPal non è andata a buon fine
>
> PayPal potrebbe non permettere ai venditori del paese della tua attività di ricevere pagamenti. Puoi ricevere pagamenti con [Base44 Payments](https://docs.base44.com/it/Setting-up-your-app/setting-up-wix-payments.md) o [Stripe](https://docs.base44.com/it/documentation/setting-up-your-app/setting-up-payments.md).

> [accordion] PayPal dice che la mia app riceve già pagamenti
>
> La tua app riceve già pagamenti tramite un altro fornitore o un negozio, e ogni app può usarne solo 1. Scollega il fornitore attuale, poi collega PayPal.

> [accordion] Il mio checkout dice che PayPal è in fase di configurazione
>
> Il tuo checkout aspetta finché PayPal non è collegato e pronto. Controlla il messaggio sotto **PayPal** nella pagina Integrations, completa ogni passaggio richiesto, poi chiedi alla chat AI di completare il checkout PayPal.

> [!NOTE]
>
> Questa pagina è stata tradotta con l'AI. Per le informazioni più accurate e aggiornate, consulta la [versione inglese](https://docs.base44.com/index.md).


## Related topics

- [Configurare Base44 Payments powered by Wix](https://docs.base44.com/it/Setting-up-your-app/setting-up-wix-payments.md)
- [Monitorare i pagamenti nella tua app](https://docs.base44.com/it/Setting-up-your-app/tracking-payments.md)
- [Configurare Stripe](https://docs.base44.com/it/documentation/setting-up-your-app/setting-up-payments.md)
- [Creare workflow per la tua app](https://docs.base44.com/it/Building-your-app/Creating-workflows.md)
- [Integrazioni IA su Base44](https://docs.base44.com/it/Integrations/AI-integrations.md)


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