Cosa ti serve
| Campo | Cosa fa |
|---|---|
| Client ID | Identifica la tua app PayPal nelle chiamate API. Abbinato al secret. |
| Client secret | La metà segreta dell'autenticazione API. Con il Client ID, crea l'ordine. Segreta. |
| Webhook ID | Identifica il webhook che PayPal firma, così possiamo verificare ogni consegna. |
| URL di conferma / URL di annullamento | Dove arriva il cliente dopo aver pagato o essersi tirato indietro. |
Perché chiediamo ogni campo
Client ID
Identifica la tua app PayPal nelle chiamate API. Funziona solo se abbinato al Client secret.
Client secret
La metà privata dell'autenticazione API. Con il Client ID, ci permette di creare l'ordine, così il pagamento passa per il tuo account.
Webhook ID
Come confermiamo che un webhook provenga davvero da PayPal: PayPal identifica ogni webhook con un ID, e lo usiamo per chiedere a PayPal direttamente se un dato messaggio è autentico. Questo impedisce a chiunque di falsificare un evento "pagato".
URL di conferma e annullamento
Impostazioni semplici: dove arriva il cliente dopo aver pagato o essersi tirato indietro. Non segrete.
Configurazione
- Apri la dashboard PayPal Developer
Accedi su developer.paypal.com. PayPal ti dà gratuitamente un Sandbox con account business e acquirenti fittizi, così puoi testare senza muovere denaro reale. Questa guida segue il Sandbox; il flusso Live è identico, basta girare il toggle Sandbox / Live (in alto a sinistra) e usare un account PayPal for Business. Dalla dashboard, apri Apps & Credentials.
PayPal Developer → Apps & Credentials - Crea un'app
Nella pagina API Credentials, conferma che il toggle Sandbox sia selezionato, poi fai clic su Create App (in alto a destra).
PayPal → Apps & Credentials → Create App - Dagli un nome e scegli Merchant
Inserisci un App Name (ad esempio "Coin Moebius"), lascia il Type su Merchant, scegli il tuo account business sandbox e fai clic su Create App.
PayPal → Create App - Copia il tuo Client ID e il Client secret
PayPal apre la tua nuova app. Copia il Client ID e rivela e copia la Secret key. (Puoi anche copiare entrambi dalla riga Default Application nell'elenco API Credentials.) Mettili da parte.
1. PayPal → API Credentials → la tua app nell'elenco 2. PayPal → la tua app → Client ID e Secret Il Client secret è segreto, trattalo come una password. L'app sandbox e l'app live hanno ciascuna la propria coppia, quindi non mescolarle.
- Aggiungi un webhook
Scorri in basso nella pagina dell'app fino alla sezione Sandbox Webhooks e fai clic su Add Webhook. Nel campo Webhook URL, incolla l'indirizzo del webhook PayPal del tuo progetto (sotto). Poi scegli gli eventi che Coin Moebius ascolta e fai clic su Save.
- Pagamenti una tantum: CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED.
- Abbonamenti (solo se li vendi): BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED. Se non fatturi su base ricorrente, salta questi.
- Di fretta? Selezionare All Events (il carattere jolly in cima) funziona lo stesso, ignoriamo tutto ciò che non usiamo.
https://api.coinmoebius.com/webhook/paypal/<your project id>PayPal → la tua app → Add webhook Il tuo id progetto si trova sotto il nome del progetto nella dashboard di Coin Moebius; inseriscilo nell'indirizzo sopra. La card del provider collegato (ultimo passaggio) mostra lo stesso URL come riferimento.
- Copia il Webhook ID
Il tuo webhook ora appare nell'elenco Sandbox Webhooks. Copia il Webhook ID mostrato accanto a esso. È così che Coin Moebius chiede a PayPal di confermare che ogni webhook sia autentico. Registra un webhook separato in sandbox e in live.
PayPal → la tua app → Sandbox Webhooks → Webhook ID - Torna in Coin Moebius: Aggiungi provider → PayPal
Nel tuo progetto, apri la scheda Provider, fai clic su Aggiungi provider, scegli Collega un servizio e seleziona PayPal. Imposta il tuo URL di conferma e URL di annullamento. Vuoi testare con credenziali sandbox? Usa la scheda Test (opzionale) e incolla il tuo Client ID, Client secret e Webhook ID, poi fai clic su Salva. Vuoi andare direttamente al live? Usa la scheda Live. Il gruppo Test è tutto-o-niente: tutti e tre i campi, o nessuno.
Coin Moebius → Aggiungi provider → PayPal - Sei collegato
PayPal ora appare nella scheda Provider con la data di collegamento (contrassegnata TEST quando hai usato credenziali sandbox). La card mostra lo stesso URL di webhook che hai incollato in PayPal, più Modifica e Scollega.
Coin Moebius → Provider → PayPal (collegato) - Testa con un acquirente sandbox
Per pagare attraverso un checkout di prova, hai bisogno del login del tuo acquirente sandbox. In PayPal, apri Testing Tools → Sandbox Accounts per vedere i tuoi account Business e Personal fittizi.
PayPal → Testing Tools → Sandbox Accounts - Ottieni i dati di accesso dell'acquirente
Apri l'account Personal (acquirente) per vedere le sue Login Info: l'URL sandbox, l'email e la password. Accedi su sandbox.paypal.com con queste credenziali quando un checkout di prova ti chiede di pagare. Non si muove denaro reale.
PayPal → Account sandbox → Login Info
Dopo aver collegato
Esegui un pagamento di prova prima di andare in produzione:
- Crea un prodotto e imposta il suo Ambiente su Testing. Questo esegue il prodotto sulle tue credenziali sandbox, così puoi piazzare un ordine completo senza muovere denaro. (Se hai saltato il set sandbox, un prodotto in Testing ricade su live, quindi aggiungilo prima.)
- Metti il pulsante di acquisto su una pagina (un file HTML locale va bene) puntato sul tuo progetto.
- Completa il checkout pagando con il tuo account acquirente sandbox.
- Apri la scheda Transazioni. Appare una nuova riga, etichettata Testing. Quando il suo stato raggiunge succeeded, le tue credenziali e il webhook funzionano entrambi da capo a fondo.
Cambia l'Ambiente del prodotto su Live quando sei pronto per i pagamenti reali.
Risoluzione dei problemi
Inizia da Verifica. Nella dashboard, fai clic su Verifica (o Verifica credenziali di test per la sandbox) per controllare le tue credenziali client.
La verifica fallisce.
Ricopia il Client ID e il Client secret. L'app sandbox e l'app live hanno coppie diverse, quindi non mescolarle.
Il pagamento si completa ma l'ordine resta in sospeso.
Il Webhook ID deve provenire dalla stessa app e ambiente delle tue credenziali client. Le credenziali live richiedono il webhook ID live. Conferma che l'URL del webhook corrisponda.
Conferma da capo a fondo.
PayPal Developer Dashboard → Webhooks Simulator: invia un evento di esempio al tuo URL di webhook, poi guarda l'ordine aggiornarsi.
Buono a sapersi
Ruotare i secret. Genera un nuovo client secret quando vuoi, poi incollalo. I campi segreti restano vuoti in modifica.
Domande? Join our Discord