PayPal Sandbox vs Production: differenze
Sviluppare integrazioni PayPal richiede di conoscere bene la differenza tra Sandbox e Production. La Sandbox è l'ambiente di test gratuito che replica le funzioni dell'ambiente reale ma con denaro virtuale e account fittizi. Production (Live) è invece l'ambiente reale, con denaro vero, regole antifrode e limitazioni di compliance attive. Vediamo le differenze fondamentali, le insidie e come passare in produzione senza imprevisti.
Endpoint e dashboard separati
Sandbox e Live hanno URL distinti per ogni servizio. Sandbox: developer.paypal.com per il dashboard, api-m.sandbox.paypal.com per le REST API, sandbox.paypal.com per il flusso utente buyer, ipnpb.sandbox.paypal.com per IPN. Live: paypal.com per dashboard merchant, api-m.paypal.com per REST, www.paypal.com per buyer, ipnpb.paypal.com per IPN. Le credenziali (client_id, client_secret) sono diverse e non interscambiabili.
Account di test
Nella Sandbox crei account "fake" buyer e seller con saldo virtuale (di default 5.000 USD). Vai su Developer Dashboard, Accounts: ne trovi due preimpostati e puoi crearne altri. Ogni account ha email, password, carta di credito di test, saldo personalizzabile. Usa il buyer per simulare il pagamento e il seller per ricevere il fondo virtuale. I dati di test (carta 4032030000007999, expiry futuro) sono pubblici e documentati.
Limitazioni della Sandbox
La Sandbox non replica al 100% Live. Le differenze più note: antifrode meno aggressiva (transazioni che in Live verrebbero bloccate, in Sandbox passano), 3D Secure opzionale, commissioni virtuali non addebitate, webhook simulator aggiuntivo, account country non sempre coerente con il merchant reale. Risultato: un'integrazione funzionante in Sandbox può comportarsi diversamente in Live. Testa sempre con almeno una transazione reale prima di lanciare.
Procedura passo-passo
- Accedi a developer.paypal.com e crea un'app REST per Sandbox.
- Copia client_id e secret Sandbox.
- Sviluppa la tua integrazione usando endpoint api-m.sandbox.paypal.com.
- Crea o usa account buyer/seller test dalla scheda Accounts.
- Esegui transazioni di test simulando ogni scenario (successo, rifiuto, rimborso).
- Verifica i log webhook nel dashboard Sandbox.
- Crea un'app REST separata per Live e copia client_id/secret Live.
- Aggiorna la configurazione del tuo software con le credenziali Live e gli endpoint api-m.paypal.com.
- Esegui una transazione reale di importo minimo (1-2 euro) e completa il ciclo.
- Verifica IPN/webhook e logging.
Best practice per ambienti separati
Tieni i due ambienti rigorosamente isolati. Variabili d'ambiente diverse (PAYPAL_ENV=sandbox vs production), database separati per ordini di test, log distinti. Mai mescolare client_id Sandbox e endpoint Live (o viceversa): la chiamata fallisce con "Authentication failed". Per i team usa account Sandbox per ogni sviluppatore e un'account Live condiviso per il produzione. Documenta le credenziali in un password manager aziendale.
Passaggio in produzione: checklist
Prima di andare Live verifica: HTTPS valido in produzione, webhook registrati con URL produzione, ordini di test su Sandbox completati per ogni flusso, logica idempotente, gestione errori implementata, refund testato, refund parziale testato, account PayPal Business verificato, IVA configurata correttamente nei prodotti. Per il primo ordine reale fai tu stesso un'acquisto di pochi euro: chiude il ciclo end-to-end e valida tutto.
Errori comuni e come risolverli
- Mescolare credenziali ed endpoint: client_id Live su endpoint Sandbox = "Auth failed". Verifica entrambi.
- Account buyer Sandbox in un paese diverso dal seller: alcuni flussi (Pay in 3) richiedono coerenza geografica.
- Testare solo successo: testa anche rifiuti, timeout, importi sotto il minimo, valute non supportate.
- Lanciare in Live senza ordine reale di prova: i clienti reali scoprono i bug. Testa tu prima.
Domande frequenti
D: Posso convertire un'app Sandbox in Live?
R: No, sono entità separate. Crei una nuova app nel pannello Live.
D: Le transazioni Sandbox vengono mai cancellate?
R: I dati di Sandbox sono persistenti ma PayPal può fare reset periodici dell'ambiente. Non fare affidamento su dati a lungo termine.
D: Sandbox supporta Pay in 3?
R: Sì, ma con account buyer con paese impostato su Italia/EU.
Consigli operativi e best practice
Per consolidare quanto visto nei paragrafi precedenti tieni a mente alcuni accorgimenti pratici che fanno la differenza nel quotidiano. Documenta sempre ogni passaggio della configurazione in un registro interno aziendale: serve sia per il team sia in caso di audit fiscale o di richiesta di chiarimenti da parte di PayPal. Conserva una copia delle ricevute, delle email transazionali e degli screenshot dei pannelli di amministrazione per almeno dieci anni, come richiesto dalla normativa civilistica italiana.
Pianifica una revisione trimestrale della tua integrazione PayPal: verifica le commissioni applicate, controlla i tassi di contestazione, leggi gli avvisi nel Centro Risoluzioni e aggiorna eventuali plugin o SDK obsoleti. Le aziende che fanno questo controllo regolare riducono del 40-60% gli incidenti operativi rispetto a chi gestisce PayPal in modo reattivo. Coinvolgi anche il team di customer service: spesso sono loro i primi a notare pattern di richieste che possono indicare problemi nascosti nel flusso di pagamento.
Infine, abituati a monitorare i tempi di risposta nelle dispute e nei reclami: PayPal premia i merchant che rispondono entro 24-48 ore con score reputazionali migliori, che si traducono in minori riserve, commissioni più favorevoli al raggiungimento dei volumi e un'esperienza più fluida in caso di controlli antifrode. La gestione proattiva è sempre meno costosa di quella reattiva, in PayPal come nel resto del business online.
Hai bisogno di aiuto?
Se vuoi integrare PayPal nel tuo sito con il team di G Tech Group, scrivici tramite il modulo di contatto.