Teknisk oversigt

PDT (Payment Data Transfer - Overførsel af betalingsdata) giver forhandlere med mulighed for at vise transaktionsoplysninger til købere, der føres tilbage til forhandlerens website efter fuldført betaling.

Sådan fungerer det

Når du har aktiveret overførsel af betalingsdata, vil en transaktionstoken blive sendt med som en "HENT"-variabel til din retur-URL, hver gang en køber foretager en websitebetaling og bliver omdirigeret til denne retur-URL. For at kunne bruge overførsel af betalingsdata og vise transaktionsoplysninger til din kunde, skal du hente denne transaktionstoken, variabelnavn "tx" og indhente transaktionsoplysningerne fra PayPal ved at konstruere en HTTP-POST til PayPal.

Din POST skal sendes til https://www.paypal.com/cgi-bin/webscr. Du skal postere denne transaktionstoken ved hjælp af variabel "tx" og værdien af den tidligere modtagne transaktionstoken (f.eks. "tx=transaktions_token") og den særlige identitetstoken ved hjælp af variablen at og værdien af din identitetstoken for overførsel af betalingsdata (f.eks."at=identitets_token"). Du skal også føje en variabel med navnet "cmd" med værdien "_notify-synch" (f.eks. cmd=_notify-synch) til POST-strengen.

PayPal svarer med et enkelt ord, "SUCCES" eller "FEJL", på en linje i svarets brødtekst. Når du modtager svaret SUCCES, vil resten af svarteksten være transaktionsoplysningerne, en pr. linje i formatet nøgle=værdi, hvor nøgle og værdi begge vil være URL-kodede strenge. Disse svardata skal parses korrekt og derefter webafkodes.

Eksempel på vellykket svar:
SUCCES
first_name=Jane+Doe
last_name=Smith
payment_status=Completed
payer_email=janiedoesmith@hotmail.com
payment_gross=3,99
mc_currency=USD
custom=For+køb+af+den+sjældne+bog+Grønne+æg+%26+skinke
...

Du kan vise de betalingsoplysninger til din kunde, som du selv synes passende, men PayPal anbefaler, at du inkluderer forsendelsesadresse, betalers e-mail og det betalte beløb. Hvis du bruger overførsel af betalingsdata til at afgøre, hvornår en bestilling skal opfyldes automatisk, skal du bekræfte, at payment_status er Completed, da køber kan bruge metoder som eChecks, der ikke umiddelbart clearer.

Hvis du bruger disse data til at opfylde bestillinger, anbefaler PayPal på det kraftigste, at du aktiverer IPN for at afgøre, hvornår de afventende betalinger er clearet. Du kan få flere oplysninger i PayPals IPN-manual, der er tilgængelig på PayPals website.

Hvis svaret er FEJL, kan du prøve at poste tilbage til PayPal igen for at afgøre, om det var en netværksfejl, der resulterede i fejlen. Hvis det andet forsøg også mislykkes, anbefaler PayPal, at du kontrollerer dit script og undersøger yderligere:

Kontroller, at txn_id ikke er en dublet for at forhindre andre personer i at genbruge en gammel, gennemført transaktion.
Valider, at receiver_email er en e-mailadresse, der er registreret på din PayPal-konto, for at forhindre betalingen i at blive sendt til en svindlers konto.
Kontroller andre transaktionsoplysninger, f.eks. varenummer og pris, for at bekræfte, at prisen ikke er blevet ændret.

IPN-variabler

Du kan finde en komplet liste over alle IPN-variabler og detaljerede instruktioner i, hvordan man bruger Meddelelse om øjeblikkelig betaling, i Integrationsvejledning til Website Payments Standard

Adobe Acrobat er påkrævet for at kunne læse PayPals manualer.