Riferimenti API
Le API di PayPal (Application Programming Interface) sono interfacce di programmazione che offrono strumenti per gestire le funzionalità messe a disposizione da PayPal.
Per utilizzare le API di PayPal è necessario disporre di un conto PayPal come pure dei Permessi API, per un accesso sicuro ai dati. PayPal dispone di diverse API per la procedura di pagamento, per la ricerca e l'elaborazione delle transazioni ed altre funzioni.
Operazioni API
PayPal mette a disposizione le seguenti operazioni API:
| Operazione API | Descrizione |
|---|---|
| TransactionSearch | Cerca le transazioni in base a uno o più criteri. |
| GetTransactionDetails | Richiama informazioni dettagliate su una determinata transazione PayPal. |
| RefundTransaction | Offre dei rimborsi su determinate transazioni. |
| MassPay | Invia denaro a uno o più riceventi. |
| SetExpressCheckout | Avvia una transazione con il Pagamento express. |
| GetExpress CheckoutDetails |
Si riferisce alle informazioni su di una transazione tramite il Pagamento express. |
| DoExpress CheckoutPayment |
Conclude una transazione con il Pagamento express. |
Utilizzo delle API di PayPal
Una volta ottenuti e installati i Permessi API, è possibile cominciare ad effettuare subito le corrispondenti chiamate. Sono disponibili due interfacce. Ti consigliamo di scegliere quella che si avvicina di più alle tue conoscenze di programmazione e che si adatta meglio all'ambiente di sviluppo selezionato:
1. Interfaccia Name-Value-Pair (NVP) - Vengono scambiati parametri fissi (Nome) e le variabili corrispondenti (Values) tramite HTTP. Questa interfaccia di programmazione si addice particolarmente allo sviluppo semplice con linguaggi server tradizionali.
2. Interfaccia-SOAP- I dati vengono scambiati su protocollo SOAP (Simple Object Access Protocol). Questa interfaccia di programmazione è particolarmente indicata per lo sviluppo orientato agli oggetti.
Messaggi di errore
In caso di problemi con una chiamata API, PayPal restituisce dei messaggi di errore dettagliati che ti aiutano a comprendere e risolvere l'inconveniente. Per una lista dei messaggi di errore (in inglese) consulta https://www.paypal.com/IntegrationCenter/ic_api-errors.html.
End point API
Gli end point delle API si distinguono in base al meccanismo di identificazione utilizzato e all'interfaccia scelta. Vengono qui di seguito elencati gli end point per ciascun ambiente di sviluppo:
| Ambiente | Autenticazione | Interfaccia | End point |
|---|---|---|---|
| Live | Certificato API | Name-Value Pair | https://api.paypal.com/nvp |
| Live | Firma API | Name-Value Pair | https://api-3t.paypal.com/nvp |
| Live | Certificato API | SOAP | https://api.paypal.com/2.0/ |
| Live | Firma API | SOAP | https://api-3t.paypal.com/2.0/ |
| Sandbox | Certificato API | Name-Value Pair | https://api.sandbox.paypal.com/nvp |
| Sandbox | Firma API | Name-Value Pair | https://api.sandbox.paypal.com/nvp |
| Sandbox | Certificato API | SOAP | https://api.sandbox.paypal.com/2.0/ |
| Sandbox | Firma API | SOAP | https://api.sandbox.paypal.com/2.0/ |
Per scegliere la soluzione PayPal più adatta a te, consulta la nostra scelta guidata.
Ecco come:
1) Vai su paypal.it e registrati o, se hai già un conto, accedi.
2) Dalle Informazioni generali sul conto, clicca su Profilo.
3) Nella prima colonna, clicca su Notifiche e spunta Aggiornamenti per sviluppatori PayPal.
