Overdracht van betaalgegevens
Inleiding
Technisch overzicht
Handleiding
Codevoorbeelden


Technisch overzicht


Overdracht van betaalgegevens biedt webwinkels de mogelijkheid om transactiegegevens te tonen aan klanten die na voltooiing van een betaling worden teruggestuurd naar de website.

Hoe het werkt

Zodra u Overdracht van betaalgegevens heeft geactiveerd en wanneer een koper een websitebetaling doet en wordt teruggestuurd naar de retour-URL, wordt er een token voor de transactie doorgegeven als een "GET"-variabele met deze retour-URL. Om Overdracht van betaalgegevens goed te gebruiken en transactiegegevens te tonen aan uw klant, moet u de transactie-token ophalen met de variabelenaam "tx", en de transactiegegevens ophalen van PayPal door een HTTP POST naar PayPal uit te voeren.

De POST moet worden verzonden aan https://www.paypal.com/cgi-bin/webscr. U moet de transactie-token posten met de variabele "tx" en de waarde van de transactie-token die u eerder heeft ontvangen (bijv. "tx=transaction_token"), en de speciale identiteitstoken met de variabele en de waarde van uw identiteitstoken van Overdracht van betaalgegevens (bijv. "at=identity_token"). U dient ook een variabele met de naam "cmd" toe te voegen aan de waarde "_notify-synch", bijvoorbeeld "cmd=_notify-synch", aan de POST-string.

PayPal reageert op de post met één woord: SUCCESS of FAIL. Dit wordt getoond op één regel in de hoofdtekst van de reactie. Wanner u een SUCCESS-reactie ontvangt, bevat de rest van de hoofdtekst de transactiegegevens, één per regel, in de indeling sleutel=waarde. Zowel de sleutel als de waarde zijn tekenreeksen in URL-indeling. Deze reactiegegevens moeten goed worden ontleed en gedecodeerd.

Voorbeeld van reactie op geslaagde transactie:
SUCCESS
first_name=Jane+Doe
last_name=Smith
payment_status=Completed
payer_email=janiedoesmith@hotmail.com
payment_gross=3,99
mc_currency=USD
custom=For+the+purchase+of+the+rare+book+Green+Eggs+%26+Ham
...

U kunt uw klant alle gewenste betaalgegevens tonen. PayPal raadt u aan in ieder geval het verzendadres, het e-mailadres van de koper en het betaalde bedrag te vermelden. Als u Overdracht van betaalgegevens gebruikt om een bestelling automatisch af te handelen, controleer dan of de waarde payment_status "Completed" is. De koper kan namelijk methoden zoals uitgestelde bankbetalingen gebruiken, die niet direct beschikbaar zijn.

Als u deze gegevens gebruikt om bestellingen af te handelen, ] raadt PayPal u aan IPN te gebruiken om vast te stellen wanneer betalingen in behandeling worden voltooid. Zie voor meer informatie de IPN-handleiding op de PayPal-website.

Als de reactie "FAIL" is, kunt u proberen terug te posten aan PayPal om vast te stellen of de fout het gevolg is van een netwerkstoring. Als de tweede poging ook mislukt, raadt PayPal u echter aan uw script te controleren en verder te onderzoeken:
  • Controleer of de "txn_id" geen duplicaat is, om te voorkomen dat iemand een oude, reeds uitgevoerde transactie opnieuw gebruikt
  • Controleer of de "receiver_email" een in uw PayPal-rekening geregistreerd e-mailadres is, om te voorkomen dat de betaling wordt verzonden vanuit de rekening van een fraudeur
  • Controleer overige transactiegegevens zoals het objectnummer en de prijs om te bevestigen dat de prijs niet is gewijzigd

IPN-variabelen (direct bericht van betaling)

Voor een volledige lijst met alle variabelen en uitgebreide instructies voor het gebruik van Direct bericht van betaling raadpleegt u de Website Payments Standard Integration Guide

Adobe Acrobat is vereist om de handleidingen van PayPal te kunnen lezen.