Express Checkout Shortcut (ECS)

PayPal ist ein internationales E-Commerce-Unternehmen, das Online-Zahlungen und Geldüberweisungen ermöglicht.

Express Checkout Shortcut (ECS): Kunden klicken auf Ihrer Website auf die Schaltfläche "Direkt zu PayPal" und werden zu den Servern von PayPal weitergeleitet.

Unterstützte Kundenländer	Keine Einschränkungen für Kundenländer.
Unterstützte Währungen	AUD, CAD, EUR, GBP, JPY, USD
Rückerstattungen	Vollständige und teilweise Erstattung möglich.
Rückbuchungen	Streitigkeiten werden von PayPal verwaltet.
Zero-authorisation	Nicht unterstützt.
Wiederkehrende Zahlungen	Nicht unterstützt.

Vorteile der Umsetzung ECS

Der Kunde braucht seine Lieferadresse nicht einzugeben. Er kann die in seinem PayPal-Konto gespeicherten Daten verwenden.
Die Vereinfachung der Kaufabwicklung kann dazu beitragen, die Konversionsraten sowohl online als auch mobil zu erhöhen.
Ermöglicht es Ihnen, der Transaktion eine Liefergebühr hinzuzufügen, die je nach der vom Kunden auf der PayPal-Website ausgewählten Lieferadresse unterschiedlich sein kann.

Überblick über den Prozess

Was wird der Kunde sehen?

Auf Ihrer Warenkorbseite bietet Ihre Website dem Kunden die Möglichkeit, mit PayPal zu bezahlen.
Der Kunde klickt auf die Schaltfläche und wird zu PayPal weitergeleitet, wo er sich mit seinen PayPal-Anmeldedaten anmeldet (er kann sich bei PayPal registrieren, wenn er noch kein Konto hat).
Der Kunde wählt auf der Website von PayPal seine bevorzugte Lieferadresse und Zahlungsmethode aus.
Der Kunde wird zurück auf Ihre Website geleitet, wo Sie zusätzliche Lieferkosten hinzufügen und eine abschließende Zusammenfassung mit dem Gesamtbetrag anzeigen können.
Der Kunde stimmt der Zahlung auf Ihrer Website zu und erhält eine Kaufbestätigung.

Wie funktioniert das hinter den Kulissen?

Initiieren Sie den Kunden
- Der Kunde erklärt sich mit einer Zahlung über PayPal auf der Website des Händlers einverstanden.
- Der Händler sendet eine Anfrage an ORDER , um die Sitzung zu initiieren, einschließlich cancelurl und returnurl.
- Der Händler erhält die Antwort ORDER , einschließlich paypaltoken und redirecturl.
Weiterleitung zu PayPal
- Der Händler leitet den Browser des Kunden auf die redirecturl, einschließlich der paypaltoken.
- Der Kunde meldet sich an und erklärt sich mit der Zahlung über sein PayPal-Konto einverstanden.
- Bei Erfolg wird der Browser des Kunden auf die Seite returnurl.
- Wenn die PayPal-Bestellung abgebrochen wird, wird der Browser auf die Seite cancelurl wo eine Fehlermeldung angezeigt werden kann. Wir empfehlen, dass alternative Zahlungsmethoden angezeigt werden, damit der Kunde es erneut versuchen kann.
Auftragsdetails abrufen
- Nur wenn dies erfolgreich war, sendet der Händler eine ORDERDETAILS Anfrage, um die Transaktionsdaten von PayPal abzurufen.
- Der Händler erhält die Antwort ORDERDETAILS und verwendet diese, um dem Kunden eine Zusammenfassung der Bestellung anzuzeigen.
Verarbeiten Sie die Autorisierung
- Wenn der Kunde dem Kauf auf Ihrer Website zustimmt, sendet der Händler eine Anfrage an AUTH , um die Zahlung zu verarbeiten.
- Der Händler erhält die Antwort AUTH und zeigt dem Kunden die Quittungsseite an.
Abschluss der Zahlung
- In der Standardeinstellung befindet sich die Transaktion in einem schwebenden Zustand, und das Geld wird normalerweise innerhalb von 24 Stunden überwiesen.
- Wenn Sie es vorziehen, können Händler ihre Einstellungen so konfigurieren, dass sie stattdessen die sofortige Abrechnung der Gelder verlangen. Alternativ kann Abrechnung für bis zu 7 Tage aufgeschoben werden.
- Eine URL-Benachrichtigung kann so konfiguriert werden, dass das System des Händlers aktualisiert wird, sobald Abrechnung abgeschlossen ist. Klicken Sie hier, um mehr zu erfahren.

1. Initiieren Sie den Kunden

Sie müssen dem Kunden die Möglichkeit geben, mit PayPal zu bezahlen.

Anzeige von PayPal auf Ihrer Kasse

PayPal stellt eine Schaltfläche zur Verfügung, die Sie in Ihre Website einfügen können, sowie Richtlinien und Hinweise zur Verwendung der Schaltfläche.
Klicken Sie hier, um die neuesten offiziellen "Direkt zu PayPal"-Schaltflächen herunterzuladen (Link zu externer Website).

Die Schaltfläche "Direkt zu PayPal" muss den Kunden ohne Umwege oder Zwischenschritte direkt zu PayPal leiten und anschließend auf Ihre Website zurückführen. Der Kunde darf nicht aufgefordert werden, sich vor dem Kauf bei einem Geschäftskonto anzumelden. Darüber hinaus sollte die Schaltfläche:

Wird direkt unter oder neben jeder Ihrer eigenen Kassenschaltflächen platziert.
Sie müssen oberhalb der Falz platziert werden (sichtbar, ohne dass man scrollen muss).
Alternativtext "Kasse mit PayPal" für den Fall, dass das Bild im Browser des Kunden nicht geladen wird.

Diese Richtlinien werden von PayPal vorgegeben und können sich jederzeit ändern.

Wenn der Kunde auf die Schaltfläche "Direkt zu PayPal" klickt, muss Ihr System eine ORDER -Anfrage durchführen und die zurückgegebene Antwort interpretieren.

ORDER Beispiel anfordern

#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

order = {
  "currencyiso3a": "GBP",
  "requesttypedescription": "ORDER",
  "accounttypedescription": "ECOM",
  "sitereference": "test_site12345",
  "baseamount": "2001",
  "paymenttypedescription": "PAYPAL",
  "returnurl": "https://yourwebsite.com",
  "cancelurl": "https://yourwebsite.com",
  "paypallocale": "GB",
  "paypaladdressoverride": "1",
  "paypalemail": "billing@email.com"
}

strequest = securetrading.Request()
strequest.update(order)
stresponse = st.process(strequest) #stresponse contains the transaction response

<?php

if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);

$configData = array(
  'username' => 'webservices@example.com',
  'password' => 'Password1^'
);

$requestData = array(
  'currencyiso3a' => 'GBP',
  'requesttypedescription' => 'ORDER',
  'accounttypedescription' => 'ECOM',
  'sitereference' => 'test_site12345',
  'baseamount' => '2001',
  'paymenttypedescription' => 'PAYPAL',
  'returnurl' => 'https://yourwebsite.com',
  'cancelurl' => 'https://yourwebsite.com',
  'paypallocale' => 'GB',
  'paypaladdressoverride' => '1',
  'paypalemail' => 'billing@email.com'
);

$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());

?>

curl --user webservices@example.com:Password1^ <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
  "alias": "webservices@example.com",
  "version": "1.00",
  "request": [{
    "currencyiso3a": "GBP",
    "requesttypedescription": "ORDER",
    "accounttypedescription": "ECOM",
    "sitereference": "test_site12345",
    "baseamount": "2001",
    "paymenttypedescription": "PAYPAL",
    "returnurl": "https://yourwebsite.com",
    "cancelurl": "https://yourwebsite.com",
    "paypallocale": "GB",
    "paypaladdressoverride": "1",
    "paypalemail": "billing@email.com"
  }]
}'

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "currencyiso3a":"GBP",
    "requesttypedescription":"ORDER",
    "accounttypedescription":"ECOM",
    "sitereference":"test_site12345",
    "baseamount":"2001",
    "paymenttypedescription":"PAYPAL",
    "returnurl":"https://yourwebsite.com",
    "cancelurl":"https://yourwebsite.com",
    "paypallocale":"GB",
    "paypaladdressoverride":"1",
    "paypalemail":"billing@email.com"
  }]
}

<requestblock version="3.67">
  <alias>webservices@example.com</alias>
  <request type="ORDER">
    <merchant>
      <returnurl>https://www.example.com/return</returnurl>
      <cancelurl>https://www.example.com/cancel</cancelurl>
    </merchant>
    <billing>
      <amount currencycode="GBP">2001</amount>
      <payment type="PAYPAL">
        <locale>GB</locale>
        <paypaladdressoverride>0</paypaladdressoverride>
        <paypalemail>billing@email.com</paypalemail>
      </payment>
    </billing>
    <operation>
      <sitereference>test_site12345</sitereference>
      <accounttypedescription>ECOM</accounttypedescription>
    </operation>
  </request>
</requestblock>

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.

Feldspezifikation

Feld	Format	Beschreibung
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Nur "ECOM" (E-Commerce) wird unterstützt.
baseamount XPath: /billing/amount	Numerisch (11)	Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. €10 werden als €1000 übermittelt. Dieser Wert muss größer als Null sein. (Die maximale Länge kann je nach Bank variieren - weitere Informationen erhalten Sie von Ihrer Bank)
cancelurl XPath: /merchant/cancelurl	URL (2048)	Die URL, zu der der Kunde zurückgeführt wird, wenn er die Autorisierung auf seinem PayPal-Konto storniert.
currencyiso3a XPath: /billing/amount/@currencycode	Alpha (3)	Die Währung , in der die Transaktion verarbeitet werden soll (im ISO3A-Format). Eine Liste der von PayPal unterstützten Währung Codes finden Sie in der Liste oben auf dieser Seite.
customerprefixname XPath: /customer/name/prefix	Alphanumerisch einschließlich Symbole (25)	Das Präfix des Rechnungsnamens des Kunden (z. B. Herr, Frau, Dr.). Mindestens eines der Felder für den Kundennamen muss ausgefüllt werden, wenn paypaladdressoverride auf "0" oder "1" gesetzt ist. Andernfalls sind diese Felder optional.
customerfirstname XPath: /customer/name/first	Alphanumerisch einschließlich Symbole (127)	Der Kunde ist Rechnungsvorname. Mindestens eines der Felder für den Kundennamen muss ausgefüllt werden, wenn paypaladdressoverride auf "0" oder "1" gesetzt ist. Andernfalls sind diese Felder optional.
customermiddlename XPath: /customer/name/middle	Alphanumerisch einschließlich Symbole (127)	Der/die mittlere(n) Rechnungsname(n) des Kunden. Mindestens eines der Felder für den Kundennamen muss ausgefüllt werden, wenn paypaladdressoverride auf "0" oder "1" gesetzt ist. Andernfalls sind diese Felder optional.
customerlastname XPath: /customer/name/last	Alphanumerisch einschließlich Symbole (127)	Der Kunde ist Rechnungsnachname. Mindestens eines der Felder für den Kundennamen muss ausgefüllt werden, wenn paypaladdressoverride auf "0" oder "1" gesetzt ist. Andernfalls sind diese Felder optional.
customersuffixname XPath: /customer/name/suffix	Alphanumerisch einschließlich Symbole (25)	Der Suffixname des Kunden (z. B. Bsc). Mindestens eines der Felder für den Kundennamen muss ausgefüllt werden, wenn paypaladdressoverride auf "0" oder "1" gesetzt ist. Andernfalls sind diese Felder optional.
customerpremise XPath: /customer/premise	Alphanumerisch einschließlich Symbole (25)	Der Name oder die Hausnummer des Kunden. Diese Kundenadressfelder sind erforderlich, wenn paypaladdressoverride auf "0" oder "1" gesetzt ist. Andernfalls sind diese Felder optional.
customertown XPath: /customer/town	Alphanumerisch einschließlich Symbole (127)	Die Stadt des Kunden. Diese Kundenadressfelder sind erforderlich, wenn paypaladdressoverride auf "0" oder "1" gesetzt ist. Andernfalls sind diese Felder optional.
customercountryiso2a XPath: /customer/country	Alpha (2)	Das Land des Kunden. Dieses muss im ISO2A-Format angegeben werden. Klicken Sie hier für eine vollständige Liste der Ländercodes. Diese Kundenadressfelder sind erforderlich, wenn paypaladdressoverride auf "0" oder "1" gesetzt ist. Andernfalls sind diese Felder optional.
customerstreet XPath: /customer/street	Alphanumerisch einschließlich Symbole (127)	Der Straßenname des Kunden.
customercounty XPath: /customer/county	Alphanumerisch einschließlich Symbole (127)	Der Bezirk des Kunden. Bei US-Adressen wird der Bundesstaat in dieses Feld eingegeben. Gültige Formate: Bevorzugt: Zweistelliger Zustandscode, z. B. "NY". Vollständiger Name des Staates, z. B. "New York". Erforderlich, wenn customercountryiso2a ist eine der folgenden: AR, BR, CA, CN, ID, IN, IT, JP, MX, TH, US
customerpostcode XPath: /customer/postcode	Alphanumerisch (25)	Die Postleitzahl des Kunden oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für den customercountryiso2a vorgelegt.
orderreference XPath: /merchant/orderreference	Alphanumerisch einschließlich Symbole (25) Empfohlene Länge 25 Zeichen oder weniger (genaue Länge abhängig von der erwerbenden Bank). Die Nichteinhaltung dieser Anforderung kann dazu führen, dass der Text in der Transaktion abgeschnitten wird.	Ihre eindeutige Bestellnummer, die auf Trust Payments und im PayPal-System gespeichert werden kann (dies ist Ihre PayPal-Rechnungs-ID). Achten Sie bitte bei der Übermittlung darauf, dass die Bestellnummer für jede Bestellung eindeutig ist.
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Dieser Wert muss als "PAYPAL" angegeben werden.
paypaladdressoverride XPath: /billing/payment/paypaladdressoverride	Numerisch (1)	Ermöglicht es Ihnen, die vom Kunden bei PayPal gewählte Lieferadresse außer Kraft zu setzen: 0 - Dem Kunden wird die Wahl zwischen der auf Ihrer Website eingegebenen Lieferadresse und den Adressen in seinem PayPal Konto angeboten. 1 - Der Kunde verwendet die auf Ihrer Website angegebene Lieferadresse. 2 - Der Kunde wird auf der Website PayPalnicht aufgefordert, eine Lieferadresse auszuwählen (am besten geeignet für Online-Dienste und Downloads).
paypalemail XPath: /billing/payment/paypalemail	E-Mail (255)	Die E-Mail-Adresse, die der Kunde für die Anmeldung bei PayPal verwenden wird. Vor dem @-Symbol sind maximal 64 Zeichen zulässig.
paypallocale XPath: /billing/payment/locale	Alpha (2)	Die Sprache der PayPal-Anmeldeseite. Klicken Sie hier, um eine Liste der PayPal-Standorte zu erhalten (Link zu externer Seite).
paypalmaxbaseamount XPath: /billing/payment/paypalmaxbaseamount	Numerisch (11)	Der erwartete maximale Gesamtbetrag der gesamten Bestellung, einschließlich Versandkosten und Steuern. PayPal verwendet diesen Wert, um die Finanzierungsquelle des Käufers zu überprüfen. Muss in Basiseinheiten angegeben werden. Weitere Informationen zu diesem Feld finden Sie in der Spezifikation von PayPal selbst.
requesttypedescription XPath: /@type	Alpha (20)	Der Wert in der Anfrage muss "ORDER" lauten.
returnurl XPath: /merchant/returnurl	URL (2048)	Die URL, zu der der Kunde nach einer erfolgreichen Autorisierung auf seinem PayPal-Konto zurückgeführt wird.
sitereference XPath: /operation/sitereference	Alphanumerisch & Unterstrich (50)	Die Website-Referenz bezieht sich auf Ihr individuelles Konto, das Sie bei der Einrichtung erhalten haben. Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.

ORDER Antwortbeispiel

{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'responses': [{
u 'transactionreference': u '72-32-20002',
u 'paymenttypedescription': u 'PAYPAL',
u 'settleduedate': u '2020-06-01',
u 'transactionstartedtimestamp': u '2020-06-01 15:35:40',
u 'errormessage': u 'Ok',
u 'accounttypedescription': u 'ECOM',
u 'errorcode': u '0',
u 'redirecturl': u 'https://webapp.securetrading.net/cgi-bin/webscr?token=72x32x20002&useraction=commit&cmd=_express-checkout&paypalemail=billing%40email.com',
u 'requesttypedescription': u 'ORDER',
u 'settlestatus': u '0',
u 'operatorname': u 'webservices@example.com',
u 'livestatus': u '0',
u 'paypaltoken': u '72x32x20002'
}]
}

array(3) {
  ["requestreference"] => string(9) "A349bdehj"
  ["version"] => string(4) "1.00"
  ["responses"] =>array(1) {
    [0] => array(13) {
      ["transactionreference"] => string(11) "72-32-20002"
      ["paymenttypedescription"] => string(6) "PAYPAL"
      ["settleduedate" ]=> string(10) "2020-06-01"
      ["transactionstartedtimestamp"] => string(19) "2020-06-01 15:35:40"
      ["errormessage"] => string(2) "Ok"
      ["accounttypedescription"] => string(4) "ECOM"
      ["errorcode"] => string(1) "0"
      ["redirecturl"] => string(137) "https://webapp.securetrading.net/cgi-bin/webscr?token=72x32x20002&useraction=commit&cmd=_express-checkout&paypalemail=billing%40email.com"
      ["requesttypedescription"] => string(5) "ORDER"
      ["settlestatus"] => string(1) "0"
      ["operatorname"] => string(23) "webservices@example.com"
      ["livestatus"] => string(1) "0"
      ["paypaltoken"] => string(11) "72x32x20002"
    }
  }
}

{
  "requestreference":"W23-fjgvn3d8",
  "version":"1.00",
  "response":[{
    "transactionreference":"72-32-20002",
    "paymenttypedescription":"PAYPAL",
    "settleduedate":"2020-06-01",
    "transactionstartedtimestamp":"2020-06-01 15:35:40",
    "errormessage":"Ok",
    "accounttypedescription":"ECOM",
    "errorcode":"0",
    "redirecturl":"https://webapp.securetrading.net/cgi-bin/webscr?token=72x32x20002&useraction=commit&cmd=_express-checkout&paypalemail=billing%40email.com",
    "requesttypedescription":"ORDER",
    "settlestatus":"0",
    "operatorname":"webservices@example.com",
    "livestatus":"0",
    "paypaltoken":"72x32x20002"
  }],
  "secrand":"zO9"
}

<responseblock version="3.67">
  <requestreference>X62d3qhev</requestreference>
  <response type="ORDER">
    <merchant>
      <operatorname>webservices@example.com</operatorname>
    </merchant>
    <transactionreference>72-32-20002</transactionreference>
    <billing>
      <payment type="PAYPAL"/>
    </billing>
    <timestamp>2020-06-01 15:35:40</timestamp>
    <paypal>
      <redirecturl>https://www.paypal.com/cgi-bin/webscr?token=56604A14170900854600&amp;useraction=commit&amp;cmd=_express-checkout&amp;paypalemail=billing%40email.com</redirecturl>
      <token>56604A14170900854600</token>
    </paypal>
    <settlement>
      <settleduedate>2020-06-01</settleduedate>
      <settlestatus>0</settlestatus>
    </settlement>
    <live>1</live>
    <error>
      <message>Ok</message>
      <code>0</code>
    </error>
    <operation>
      <accounttypedescription>ECOM</accounttypedescription>
    </operation>
  </response>
  <secrand>SO</secrand>
</responseblock>

Feldspezifikation

Feld	Format	Beschreibung
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Der zurückgegebene Wert ist "ECOM".
errorcode XPath: /error/code	Numerisch (1-5)	Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht. Wenn die Fehlercode "0" ist, war die Transaktion erfolgreich. Wenn die Fehlercode nicht "0" ist, war die Transaktion nicht erfolgreich. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
errordata XPath: /error/data	Alphanumerisch (255)	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
errormessage XPath: /error/message	Alphanumerisch (255)	Dies ist die entsprechende Meldung zum obigen Code. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
livestatus XPath: /live	Numerisch (1)	0 - Die Transaktion wurde über ein Testkonto abgewickelt. 1 - Transaktion wird über ein Live-Konto abgewickelt.
operatorname XPath: /merchant/operatorname	Alphanumerisch (255)	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Der zurückgegebene Wert ist "PAYPAL".
paypaltoken XPath: /paypal/token	Alphanumerisch (255)	Das Token bezieht sich auf die Sitzung des Kunden innerhalb des PayPal-Systems. Sie sollten dies protokollieren, da Sie es dann für alle relevanten Rückfragen bei PayPal verwenden können.
redirecturl XPath: /paypal/redirecturl	URL (255)	Leiten Sie den Browser des Kunden auf diese URL um, damit er sich bei seinem PayPal-Konto anmelden kann.
requesttypedescription XPath: /@type	Alpha (20)	Der zurückgegebene Wert ist "ORDER".
settleduedate XPath: /settlement/settleduedate	Datum JJJJ-MM-TT	Das Datum, an dem die Transaktion abgewickelt wird.
settlestatus XPath: /settlement/settlestatus	Numerisch (3)	"0" bedeutet, dass bisher keine Probleme aufgetreten sind, die die Durchführung von Abrechnung verhindern würden. "3" bedeutet, dass die Anfrage erfolglos war.
transactionreference XPath: /transactionreference	Alphanumerisch einschließlich Bindestriche (25)	Eine eindeutige Referenz für die Anfrage, die von Trust Payments zugewiesen wird.
transactionstartedtimestamp XPath: /timestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	Der Zeitpunkt, zu dem die Anfrage bearbeitet wurde.

Zusätzliche Hinweise zu ORDER Anfragen

Der Kundenname, die Kundenbetriebsstätte, der Kundenort und das Kundenland sind erforderlich, wenn Sie paypaladdressoverride Optionen "0" oder "1".
Wenn PayPal eine Transaktion ablehnt, während sich der Kunde auf seinen Servern befindet, wird eine Meldung auf dem Bildschirm angezeigt. Der Kunde kann aufgefordert werden, es erneut zu versuchen oder den Zahlungsversuch abzubrechen.
Sie können Ihr PayPal-Konto so konfigurieren, dass die Prüfung auf doppelte Rechnungs-IDs (Werte, die im Feld orderreference). Wenden Sie sich für weitere Informationen an den PayPal-Support.

2. Weiterleitung zu PayPal

Nach erfolgreicher Übermittlung einer ORDER Anfrage, erhält Ihr System eine redirecturl in der Antwort. Ihr System muss den Browser des Kunden auf diese URL umleiten, die eine von PayPal gehostete Seite ist, um die Zahlung zu verarbeiten.

Beim Testen wird unsere simulierte PayPal-Anmeldeseite (wie unten gezeigt) anstelle einer echten PayPal-Anmeldeseite angezeigt.

Nach der Anmeldung bei seinem PayPal-Konto hat der Kunde die Möglichkeit, die Transaktion fortzusetzen oder abzubrechen. Beim Testen können Sie dies mit einer der unten stehenden E-Mails auf unserem Testbildschirm für die PayPal-Anmeldung nachbilden.

E-Mail-Adresse	Szenario	Ergebnis
auth@auth.com	Der Kunde führt eine erfolgreiche Transaktion durch.	Der Browser des Kunden wird zu der URL umgeleitet, die in der returnurl die mit dem Antrag ORDER eingereicht wurde.
cancel@cancel.com	Der Kunde entscheidet sich, die Transaktion zu stornieren.	Der Browser des Kunden wird zu der URL umgeleitet, die in der cancelurl die mit dem Antrag ORDER eingereicht wurde.

Sie müssen warten, bis der Kunde von der PayPal-Anmeldeseite zur returnurl die auf Ihren Servern gehostet werden, bevor eine Autorisierung verarbeitet wird.

3. Auftragsdetails abrufen

Wird der Kunde auf die Seite cancelurl:

Bieten Sie Ihren Kunden alternative Zahlungsmöglichkeiten an, damit sie es noch einmal versuchen können.

Wird der Kunde auf die Seite returnurl:

Befolgen Sie die nachstehenden Anweisungen.

ORDERDETAILS Beispiel anfordern

Hier ist ein Beispiel für eine ORDERDETAILS Anfrage. Diese Anfrage ruft die Adressdaten ab, die der Kunde auf den Servern von PayPal eingegeben hat, und gibt diese in einer Antwort an ORDERDETAILS zurück.

#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

orderdetails = {
  "requesttypedescription": "ORDERDETAILS",
  "sitereference": "test_site12345",
  "parenttransactionreference": "72-32-20002"
}

strequest = securetrading.Request()
strequest.update(orderdetails)
stresponse = st.process(strequest) #stresponse contains the transaction response

<?php

if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);

$configData = array(
  'username' => 'webservices@example.com',
  'password' => 'Password1^'
);

$requestData = array(
  'requesttypedescription' => array'ORDERDETAILS',
  'sitereference' => 'test_site12345',
  'parenttransactionreference' => '72-32-20002'
);

$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());

?>

curl --user webservices@example.com:Password1^ <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
  "alias": "webservices@example.com",
  "version": "1.00",
  "request": [{
    "requesttypedescription": "ORDERDETAILS",
    "sitereference": "test_site12345",
    "parenttransactionreference": "72-32-20002"
  }]
}'

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescription":"ORDERDETAILS",
    "sitereference":"test_site12345",
    "parenttransactionreference":"72-32-20002"
  }]
}

<requestblock version="3.67">
  <alias>webservices@example.com</alias>
  <request type="ORDERDETAILS">
    <operation>
      <sitereference>test_site12345</sitereference>
      <parenttransactionreference>72-32-20002</parenttransactionreference>
    </operation>
  </request>
</requestblock>

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.

Feldspezifikation

Feld	Format	Beschreibung
parenttransactionreference XPath: /operation/parenttransactionreference	Alphanumerisch & Bindestriche (25)	Einreichen der transactionreference der vorangegangenen Antwort von ORDER . Dies wird von der Weiterleitung von PayPal kommen.
requesttypedescription XPath: /@type	Alpha (20)	Der Wert in der Anfrage muss "ORDERDETAILS" lauten.
sitereference XPath: /operation/sitereference	Alphanumerisch & Unterstrich (50)	Die Website-Referenz bezieht sich auf Ihr individuelles Konto, das Sie bei der Einrichtung erhalten haben. Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.

ORDERDETAILS Antwort

Sie müssen die in der Antwort ORDERDETAILS zurückgegebenen Informationen verwenden, um dem Kunden auf Ihrer Website eine Seite mit einer Zusammenfassung der Bestellung anzuzeigen. Der Kunde kann diese Seite nutzen, um seine Bestellung zu überprüfen und zu bestätigen, dass er fortfahren möchte. In diesem Fall würde Ihr System eine AUTH Anfrage übermitteln, wie unten beschrieben.

Leitlinien für bewährte Praktiken

Der Kunde sollte in der Lage sein, den Kauf in zwei oder weniger Schritten abzuschließen, nachdem er von den PayPal-Kassenseiten auf Ihre Website weitergeleitet wurde.
Der Kunde darf nicht aufgefordert werden, auf der Bewertungsseite manuell zusätzliche Informationen einzugeben, die über die PayPal-APIs verfügbar sind.

Auf der oben erwähnten Bestellseite für die Überprüfung sollten dem Kunden vor Abschluss des Kaufs die folgenden Informationen angezeigt werden:

PayPal als ausgewählte Zahlungsmethode.
Lieferadresse und E-Mail-Adresse von PayPal (zu finden in der Antwort auf ORDERDETAILS).
Der vom Kunden zu zahlende Gesamtbetrag, einschließlich etwaiger zusätzlicher Lieferkosten, die zum ursprünglichen Transaktionsbetrag hinzukommen (falls zutreffend). Weitere Informationen zu den Lieferkosten finden Sie weiter unten.

Über Lieferkosten

Sobald Ihr System die Antwort ORDERDETAILS erhalten hat, sollten Sie nun im Besitz der Lieferadresse des Kunden sein (wenn Sie ein physisches Produkt versenden wollen). Zu diesem Zeitpunkt dürfen Sie den Transaktionskosten eine Liefergebühr hinzufügen.

Unabhängig von den Lieferkosten müssen Sie dem Kunden die Gesamtkosten vorlegen, und er muss diesem Endbetrag zustimmen, bevor die Zahlung bearbeitet wird. Wir empfehlen, die Kosten für das/die Produkt(e) von den Lieferkosten zu trennen, damit der Kunde besser verstehen kann, wie der Betrag berechnet wurde.

Sobald der Kunde der Zahlung zustimmt, kann Ihr System eine AUTH Anfrage mit diesem endgültigen Betrag verarbeiten, der in der baseamount Feld (wie unten beschrieben). Dieser Gesamtbetrag, einschließlich etwaiger zusätzlicher Lieferkosten, sollte nicht höher sein als der paypalmaxbaseamount Wert (falls in der Anfrage ORDER angegeben).

Die Höhe des Zuschlags zur Deckung der Lieferkosten bestimmen Sie selbst. Im Allgemeinen gibt es drei Möglichkeiten zur Berechnung der Lieferkosten:

Kostenlose Lieferung - Sie entscheiden sich dafür, keine zusätzlichen Gebühren auf die Produktkosten aufzuschlagen, und Ihr Unternehmen übernimmt die Kosten für die Lieferung.
Fester Lieferpreis - Sie entscheiden sich dafür, für jede Bestellung die gleichen Lieferkosten zu berechnen. Dies funktioniert am besten, wenn Sie sicherstellen, dass die oben genannte Gebühr denselben Wert hat wie die durchschnittlichen Lieferkosten für alle Ihre Bestellungen.
Berechnen Sie die genauen Kosten (unter Verwendung von Echtzeittarifen) - Jetzt, da Sie die Lieferadresse des Kunden sowie Größe und Gewicht der Lieferung kennen, können Sie sich mit Ihrem Versandpartner in Verbindung setzen und die genauen Lieferkosten berechnen und diese dem Kunden vor Abschluss der Zahlung mitteilen.

Hier ist ein Beispiel für eine Antwort von ORDERDETAILS :

{
u 'requestreference': u 'A0dcb11e6',
u 'version': u '1.00',
u 'responses': [{
u 'transactionreference': u '72-32-20003',
u 'merchantname': u 'Test Merchant',
u 'billinglastname': u 'PAYPALLastName',
u 'transactionstartedtimestamp': u '2020-06-01 15:36:00',
u 'paypalpayerstatus': u 'verified',
u 'parenttransactionreference': u '72-32-20002',
u 'accounttypedescription': u 'ECOM',
u 'errorcode': u '0',
u 'settleduedate': u '2020-06-01',
u 'billingcountryiso2a': u 'GB',
u 'paypalpayerid': u 'e018408a43pid',
u 'paypaladdressstatus': u 'Confirmed',
u 'billingemail': u 'paypal.email@example.com',
u 'requesttypedescription': u 'ORDERDETAILS',
u 'errormessage': u 'Ok',
u 'billingfirstname': u 'Andru00e9',
u 'operatorname': u 'webservices@example.com',
u 'livestatus': u '0',
u 'settlestatus': u '0'
}]
}

array(3) {
  ["requestreference"] => string(9) "A58cdfkpy"
  ["version"] => string(4) "1.00"
  ["responses"] => array(1) {
    [0] => array(19) {
      ["transactionreference"] => string(11) "72-32-20003"
      ["merchantname"] => string(13) "Test Merchant"
      ["billinglastname"] => string(14) "PAYPALLastName"
      ["transactionstartedtimestamp"] => string(19) "2020-06-01 15:36:00"
      ["paypalpayerstatus"] => string(8) "verified"
      ["parenttransactionreference"] => string(11) "72-32-20002"
      ["accounttypedescription"] => string(4) "ECOM"
      ["errorcode"] => string(1) "0"
      ["settleduedate"] => string(10) "2020-06-01"
      ["billingcountryiso2a"] => string(2) "GB"
      ["paypalpayerid"] => string(13) "e018408a43pid"
      ["paypaladdressstatus"] => string(9) "Confirmed"
      ["billingemail"] => string(24) "paypal.email@example.com"
      ["requesttypedescription"] => string(12) "ORDERDETAILS"
      ["errormessage"] => string(2) "Ok"
      ["billingfirstname"] => string(10) "Andru00e9"
      ["operatorname"] => string(23) "webservices@example.com"
      ["livestatus"] => string(1) "0"
      ["settlestatus"] => string(1) "0"
    }
  }
}

{
  "requestreference":"W23-fjgvn3d8",
  "version":"1.00",
  "response":[{
    "transactionreference":"72-32-20003",
    "merchantname":"Test Merchant",
    "billinglastname":"PAYPALLastName",
    "transactionstartedtimestamp":"2020-06-01 15:36:00",
    "paypalpayerstatus":"verified",
    "parenttransactionreference":"72-32-20002",
    "accounttypedescription":"ECOM",
    "errorcode":"0",
    "settleduedate":"2020-06-01",
    "billingcountryiso2a":"GB",
    "paypalpayerid":"e018408a43pid",
    "paypaladdressstatus":"Confirmed",
    "billingemail":"paypal.email@example.com",
    "requesttypedescription":"ORDERDETAILS",
    "errormessage":"Ok",
    "billingfirstname":"Andru00e9",
    "operatorname":"webservices@example.com",
    "livestatus":"0",
    "settlestatus":"0"
  }],
  "secrand":"zO9"
}

<responseblock version="3.67">
  <requestreference>X538160153</requestreference>
  <response type="ORDERDETAILS">
    <merchant>
      <merchantname>My Test Site</merchantname>
      <operatorname>webservices@example.com</operatorname>
    </merchant>
    <customer>
      <town>PAYPAL City</town>
      <county>MI</county>
      <street>MORE STREET</street>
      <name>
        <last>PayPalShipToName</last>
      </name>
      <premise>1 PayPalStreet</premise>
      <country>US</country>
    </customer>
    <transactionreference>72-32-20003</transactionreference>
    <billing>
      <name>
        <last>PAYPALLastName</last>
      </name>
      <country>GB</country>
      <email>paypal.email@example.com</email>
      <telephone type="M">0777777777</telephone>
    </billing>
    <timestamp>2020-06-01 15:36:00</timestamp>
    <paypal>
      <addressstatus>Confirmed</addressstatus>
      <payerstatus>verified</payerstatus>
      <payerid>4d22e2606apid</payerid>
    </paypal>
    <settlement>
      <settleduedate>2020-06-01</settleduedate>
      <settlestatus>0</settlestatus>
    </settlement>
    <live>1</live>
    <error>
      <message>Ok</message>
      <code>0</code>
    </error>
    <operation>
      <parenttransactionreference>72-32-20002</parenttransactionreference>
      <accounttypedescription>ECOM</accounttypedescription>
    </operation>
  </response>
  <secrand>bt</secrand>
</responseblock>

Feldspezifikation

In der folgenden Tabelle werden die wichtigsten Felder beschrieben, die in der zurückgegebenen Antwort zu überprüfen sind:

Feld	Format	Beschreibung
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Der zurückgegebene Wert ist "ECOM".
errorcode XPath: /error/code	Numerisch (1-5)	Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht. Wenn die Fehlercode "0" ist, war die Transaktion erfolgreich. Wenn die Fehlercode nicht "0" ist, war die Transaktion nicht erfolgreich. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
errordata XPath: /error/data	Alphanumerisch (255)	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
errormessage XPath: /error/message	Alphanumerisch (255)	Dies ist die entsprechende Meldung zum obigen Code. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
livestatus XPath: /live	Numerisch (1)	0 - Die Transaktion wurde über ein Testkonto abgewickelt. 1 - Transaktion wird über ein Live-Konto abgewickelt.
merchantname XPath: /merchant/merchantname	Alphanumerisch (255)	Es handelt sich dabei um Angaben zu dem Konto, über das die Transaktion abgewickelt wird. Wenn Sie diese Felder ändern möchten, wenden Sie sich bitte an unser Support-Team. Hängt von der Konfiguration Ihres Kontos ab.
operatorname XPath: /merchant/operatorname	Alphanumerisch (255)	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
parenttransactionreference XPath: /operation/parenttransactionreference	Alphanumerisch & Bindestriche (25)	Die transactionreference der vorangegangenen Antwort ORDER .
paypaladdressstatus XPath: /paypal/addressstatus	Alpha (25)	Der Status der Adresse bei PayPal. Entweder "Confirmed" oder "Unconfirmed".
paypalpayerid XPath: /billing/payment/payerid	Alphanumerisch (255)	Ungleiche PayPal-Kontonummer.
paypalpayerstatus XPath: /paypal/payerstatus	Alpha (25)	Der Status des Zahlers bei PayPal. Entweder "verified" oder "unverified".
requesttypedescription XPath: /@type	Alpha (20)	Der zurückgegebene Wert ist "ORDERDETAILS".
settleduedate XPath: /settlement/settleduedate	Datum JJJJ-MM-TT	Das Datum, an dem die Transaktion abgewickelt wird.
settlestatus XPath: /settlement/settlestatus	Numerisch (3)	"0" bedeutet, dass bisher keine Probleme aufgetreten sind, die die Durchführung von Abrechnung verhindern würden. "3" bedeutet, dass die Anfrage erfolglos war.
transactionreference XPath: /transactionreference	Alphanumerisch einschließlich Bindestriche (25)	Eine eindeutige Referenz für die Anfrage, die von Trust Payments zugewiesen wird.
transactionstartedtimestamp XPath: /timestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	Der Zeitpunkt, zu dem die Anfrage bearbeitet wurde.

Zusätzliche Hinweise zu ORDERDETAILS Antworten

Die zurückgegebenen Rechnungs- und Kundendaten können sich von denen unterscheiden, die bei der ursprünglichen ORDER -Anfrage angegeben wurden. Dies kann vorkommen, wenn der Kunde bei der Anmeldung auf den Servern von PayPal andere Daten verwendet (und paypaladdressoverride auf "0" gesetzt ist).
Die zurückgegebenen PayPal-Felder werden von PayPal definiert. Sie sind zum Zeitpunkt der Erstellung dieses Dokuments korrekt, können aber geändert werden.

4. Bearbeitung der Autorisierung

Nachdem der Kunde bestätigt hat, dass er mit der Zahlung fortfahren möchte, muss Ihr System eine AUTH Anfrage durchführen und die zurückgegebene Antwort interpretieren.

AUTH Beispiel anfordern

Hier ist ein Beispiel für eine PayPal-Anfrage AUTH . Beachten Sie, dass die Struktur ähnlich wie bei einer Standard AUTH Anfragemit Ausnahme der meisten Zahlungs-, Rechnungs- und Lieferdaten, da diese von den vorherigen Anträgen übernommen wurden. Bitte stellen Sie sicher, dass die parenttransactionreference Feld übermittelt, das die eindeutige Transaktionsnummer der vorangegangenen ORDERDETAILS Anfrage enthält.

#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

auth = {
  "requesttypedescription": "AUTH",
  "sitereference": "test_site12345",
  "parenttransactionreference": "72-32-20003",
  "paymenttypedescription": "PAYPAL",
  "paypaladdressoverride": "1"
}

strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response

<?php

if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);

$configData = array(
  'username' => 'webservices@example.com',
  'password' => 'Password1^'
);

$requestData = array(
  'requesttypedescription' => 'AUTH',
  'sitereference' => 'test_site12345',
  'parenttransactionreference' => '72-32-20003',
  'paymenttypedescription' => 'PAYPAL',
  'paypaladdressoverride' => '1'
);

$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());

?>

curl --user webservices@example.com:Password1^ <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
  "alias": "webservices@example.com",
  "version": "1.00",
  "request": [{
    "requesttypedescription": "AUTH",
    "sitereference": "test_site12345",
    "parenttransactionreference": "72-32-20003",
    "paymenttypedescription": "PAYPAL",
    "paypaladdressoverride": "1"
  }]
}'

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescription":"AUTH",
    "sitereference":"test_site12345",
    "parenttransactionreference":"72-32-20003",
    "paymenttypedescription":"PAYPAL",
    "paypaladdressoverride":"1"
  }]
}

<requestblock version="3.67">
  <alias>webservices@example.com</alias>
  <request type="AUTH">
    <operation>
      <sitereference>test_site12345</sitereference>
      <parenttransactionreference>72-32-20003</parenttransactionreference>
    </operation>
    <billing>
      <payment type="PAYPAL">
        <paypaladdressoverride>0</paypaladdressoverride>
      </payment>
    </billing>
  </request>
</requestblock>

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.

Feldspezifikation

Feld	Format	Beschreibung
parenttransactionreference XPath: /operation/parenttransactionreference	Alphanumerisch & Bindestriche (25)	Einreichen der transactionreference die in der vorangegangenen Antwort ORDERDETAILS zurückgegeben wurde.
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Dieser Wert muss als "PAYPAL" angegeben werden.
paypaladdressoverride XPath: /billing/payment/paypaladdressoverride	Numerisch (1)	Es muss derselbe Wert sein, der in der Anfrage ORDER angegeben wurde.
requesttypedescription XPath: /@type	Alpha (20)	Der Wert in der Anfrage muss "AUTH" lauten.
sitereference XPath: /operation/sitereference	Alphanumerisch & Unterstrich (50)	Die Website-Referenz bezieht sich auf Ihr individuelles Konto, das Sie bei der Einrichtung erhalten haben. Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.

AUTH Antwortbeispiel

Hier ist ein Beispiel für eine PayPal-Antwort AUTH . Die Struktur ähnelt einer Standardantwort von AUTH , mit Ausnahme der Einbeziehung zusätzlicher PayPal-spezifischer Felder.

{
u 'requestreference': u 'A0dcb11e6',
u 'version': u '1.00',
u 'responses': [{
u 'transactionreference': u '72-32-20004',
u 'merchantname': u 'Test Merchant',
u 'paymenttypedescription': u 'PAYPAL',
u 'authcode': u '44782-D149613359266',
u 'transactionstartedtimestamp': u '2020-06-01 15:36:20',
u 'errormessage': u 'Ok',
u 'parenttransactionreference': u '72-32-20003',
u 'accounttypedescription': u 'ECOM',
u 'errorcode': u '0',
u 'settleduedate': u '2020-06-01',
u 'currencyiso3a': u 'GBP',
u 'baseamount': u '2001',
u 'acquirerresponsecode': u 'None',
u 'requesttypedescription': u 'AUTH',
u 'operatorname': u 'webservices@example.com',
u 'livestatus': u '0',
u 'settlestatus': u '0'
}]
}

array(3) {
  ["requestreference"] => string(9) "A58cdfkpy"
  ["version"] => string(4) "1.00"
  ["responses"] => array(1) {
    [0] =>array(17) {
      ["transactionreference"] => string(11) "72-32-20004"
      ["merchantname"] => string(13) "Test Merchant"
      ["paymenttypedescription"] => string(6) "PAYPAL"
      ["authcode"] => string(19) "44782-D149613359266"
      ["transactionstartedtimestamp"] => string(19) "2020-06-01 15:36:20"
      ["errormessage"] => string(2) "Ok"
      ["parenttransactionreference"] => string(11) "72-32-20003"
      ["accounttypedescription"] => string(4) "ECOM"
      ["errorcode"] => string(1) "0"
      ["settleduedate"] => string(10) "2020-06-01"
      ["currencyiso3a"] => string(3) "GBP"
      ["baseamount"] => string(4) "2001"
      ["acquirerresponsecode"] => string(4) "None"
      ["requesttypedescription"] => string(4) "AUTH"
      ["operatorname"] => string(23) "webservices@example.com"
      ["livestatus"] => string(1) "0"
      ["settlestatus"] => string(1) "0"
    }
  }
}

{
  "requestreference":"W23-fjgvn3d8",
  "version":"1.00",
  "response":[{
    "transactionreference":"72-32-20004",
    "merchantname":"Test Merchant",
    "paymenttypedescription":"PAYPAL",
    "authcode":"44782-D149613359266",
    "transactionstartedtimestamp":"2020-06-01 15:36:20",
    "errormessage":"Ok",
    "parenttransactionreference":"72-32-20003",
    "accounttypedescription":"ECOM",
    "errorcode":"0",
    "settleduedate":"2020-06-01",
    "currencyiso3a":"GBP",
    "baseamount":"2001",
    "acquirerresponsecode":"None",
    "requesttypedescription":"AUTH",
    "operatorname":"webservices@example.com",
    "livestatus":"0",
    "settlestatus":"0"
  }],
  "secrand":"zO9"
}

<responseblock version="3.67">
  <requestreference>X538160153</requestreference>
  <response type="AUTH">
    <merchant>
      <merchantname>My Test Site</merchantname>
      <operatorname>webservices@example.com</operatorname>
    </merchant>
    <transactionreference>72-32-20004</transactionreference>
    <timestamp>2020-06-01 15:36:20</timestamp>
    <acquirerresponsecode>None</acquirerresponsecode>
    <operation>
      <parenttransactionreference>72-32-20003</parenttransactionreference>
      <accounttypedescription>ECOM</accounttypedescription>
    </operation>
    <settlement>
      <settleduedate>2020-06-01</settleduedate>
      <settlestatus>0</settlestatus>
    </settlement>
    <billing>
      <amount currencycode="GBP">2001</amount>
      <payment type="PAYPAL"/>
    </billing>
    <authcode>83154-D140912749345</authcode>
    <live>1</live>
    <error>
      <message>Ok</message>
      <code>0</code>
    </error>
  </response>
  <secrand>LLq</secrand>
</responseblock>

Feldspezifikation

Feld	Format	Beschreibung
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Der zurückgegebene Wert ist "ECOM".
acquirerresponsecode XPath: /acquirerresponsecode	Alphanumerisch (255)	Wird von Ihrem Acquirer verwendet, um das Ergebnis der Anfrage anzuzeigen.
authcode XPath: /authcode	Alphanumerisch (255)	Der von der ausstellenden Bank bereitgestellte Autorisierung Code. Wird nur zurückgegeben, wenn die Transaktion genehmigt ist.
baseamount XPath: /billing/amount	Numerisch (11)	Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, so dass €10 als 1000 zurückgegeben werden.
currencyiso3a XPath: /billing/amount/@currencycode	Alpha (3)	Die Währung, in der die Transaktion verarbeitet wurde (im ISO3A-Format). Eine Liste der von PayPal unterstützten Währung Codes finden Sie in der Liste oben auf dieser Seite.
errorcode XPath: /error/code	Numerisch (1-5)	Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht. Wenn die Fehlercode "0" ist, war die Transaktion erfolgreich. Wenn die Fehlercode nicht "0" ist, war die Transaktion nicht erfolgreich. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
errordata XPath: /error/data	Alphanumerisch (255)	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
errormessage XPath: /error/message	Alphanumerisch (255)	Dies ist die entsprechende Meldung zum obigen Code. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
livestatus XPath: /live	Numerisch (1)	0 - Die Transaktion wurde über ein Testkonto abgewickelt. 1 - Transaktion wird über ein Live-Konto abgewickelt.
merchantname XPath: /merchant/merchantname	Alphanumerisch (255)	Es handelt sich dabei um Angaben zu dem Konto, über das die Transaktion abgewickelt wird. Wenn Sie diese Felder ändern möchten, wenden Sie sich bitte an unser Support-Team. Hängt von der Konfiguration Ihres Kontos ab.
operatorname XPath: /merchant/operatorname	Alphanumerisch (255)	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
parenttransactionreference XPath: /operation/parenttransactionreference	Alphanumerisch & Bindestriche (25)	Die transactionreference der vorangegangenen Antwort ORDERDETAILS .
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Der zurückgegebene Wert ist "PAYPAL".
requesttypedescription XPath: /@type	Alpha (20)	Der zurückgegebene Wert ist "AUTH".
settleduedate XPath: /settlement/settleduedate	Datum JJJJ-MM-TT	Das Datum, an dem die Transaktion abgewickelt wird.
settlestatus XPath: /settlement/settlestatus	Numerisch (3)	Dieses Feld wird zur Bestimmung des Transaktionsstatus verwendet. Klicken Sie hier für weitere Informationen über die settlestatus und den Abrechnung Prozess für PayPal.
transactionreference XPath: /transactionreference	Alphanumerisch einschließlich Bindestriche (25)	Eine eindeutige Referenz für die Anfrage, die von Trust Payments zugewiesen wird.
transactionstartedtimestamp XPath: /timestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	Der Zeitpunkt, zu dem die Anfrage bearbeitet wurde.

Sie können Tokenisierung nicht mit PayPal durchführen.

Weitere Lektüre zu diesem Thema