Informazioni tecniche

Grazie alla funzione di trasferimento dei dati del pagamento (PDT) i commercianti permettono agli acquirenti di visualizzare i dettagli della transazione quando vengono reindirizzati al loro sito dopo il completamento della procedura di pagamento.

Come funziona

Dopo aver attivato la funzione di trasferimento dei dati del pagamento, ogni volta che un acquirente effettua un pagamento tramite un sito web e viene reindirizzato al tuo URL di ritorno, viene passato un messaggio di controllo (token) della transazione all'URL di ritorno come variabile "GET". Per utilizzare questa funzione in modo corretto e permettere ai tuoi clienti di consultare i dettagli sulla transazione, devi recuperare il messaggio di controllo della transazione, con il nome di variabile "tx", e prelevare i dati della transazione da PayPal formulando un POST HTTP a PayPal.

Il tuo POST deve essere inviato all'indirizzo https://www.paypal.com/cgi-bin/webscr. Il messaggio di controllo della transazione deve essere registrato utilizzando la variabile "tx" e il valore del messaggio di controllo della transazione ricevuto in precedenza (ad esempio "tx=transaction_token") e il messaggio di controllo di identità speciale utilizzando la variabile at e il valore del tuo messaggio di controllo di identità PDT (ad esempio "at=identity_token"). Inoltre, alla stringa POST devi aggiungere una variabile denominata "cmd" con il valore "_notify-synch" (ad esempio "cmd=_notify-synch".

PayPal ti invierà un'unica risposta, RIUSCITO o NON RIUSCITO, inserita in una riga del corpo del messaggio. Quando ricevi come risposta RIUSCITO, il resto del messaggio conterrà i dettagli sulla transazione, uno per ogni riga, nel formato key=value dove key e value corrisponderanno entrambi alle stringhe codificate dell'URL. I dati della risposta devono essere analizzati accuratamente e quindi decodificati nel web.

Esempio di risposta corretta:
RIUSCITO
first_name=Maria
last_name=Rossi
payment_status=Eseguito
payer_email=mariarossi@hotmail.com
payment_gross=3,99
mc_currency=USD
custom=Per+l'+acquisto+del+raro+libro+Green+Eggs+%26+Ham
...

Puoi specificare tutti i dettagli sul pagamento che ritieni necessari, anche se PayPal consiglia di inserire l'indirizzo di spedizione, l'email del debitore e l'importo pagato. Se stai utilizzando la funzione di trasferimento dei dati del pagamento per specificare quando un ordine deve essere compilato automaticamente, devi confermare che lo stato del pagamento sia Eseguito, dal momento che l'acquirente potrebbe utilizzare dei sistemi di pagamento come gli echeck che non vengono accreditati subito.

Se stai utilizzando questi dati per compilare degli ordini, PayPal consiglia vivamente di attivare la funzione di notifica immediata di pagamento per indicare quando viene effettuato l'accredito dei pagamenti in sospeso. Per maggiori informazioni, consulta il manuale IPN di PayPal disponibile sul sito web PayPal.

Se la risposta è NON RIUSCITO, puoi riprovare a effettuare la registrazione a PayPal per verificare se il problema è stato causato da un errore della rete; tuttavia, se non riesce nemmeno il secondo tentativo, PayPal consiglia di controllare lo script e effettuare i seguenti controlli e operazioni.

Assicurati che il txn_id non sia un duplicato per impedire che qualcuno possa riutilizzare una transazione vecchia già eseguita.
Verifica che il receiver_email sia un indirizzo email registrato nel tuo conto PayPal per impedire che il pagamento venga inviato da un conto contraffatto.
Controlla altri dettagli della transazione, ad esempio il numero dell'oggetto e il prezzo, per confermare che il prezzo non abbia subito variazioni.

Variabili IPN

Per un elenco completo delle variabili IPN e istruzioni dettagliate sull'utilizzo di Notifica immediata di pagamento, consulta Guida all'integrazione dei Pagamenti su sito web

Adobe Acrobat consente di leggere i manuali di PayPal.