PayPal für Payment Pages

Konfiguration

1. Um diese Zahlungsmethode für Ihr Konto zu aktivieren, befolgen Sie bitte die Schritte in unserem Leitfaden zur Aktivierung von PayPal.
2. Sobald Sie die oben genannten Schritte durchgeführt haben, müssen Sie Ihre POST an Payment Pages nach Bedarf ändern:
   
   

   Name des Feldes	Erforderlich während der Zahlungssitzung (Entweder vom Händler in POST aufgenommen oder vom Kunden auf Payment Pages eingegeben)	Erforderlich in POST	Beschreibung
   customerprefixname	Bedingt	Nein	Diese Lieferfelder sind erforderlich, wenn paypaladdressoverride 0 oder 1 ist. Sie müssen mindestens eines der Felder für den Kundennamen ausfüllen. Mindestens eines der Kundennamensfelder ist erforderlich, wenn paypaladdressoverride 0 oder 1 ist.
   customerfirstname	Bedingt	Nein
   customermiddlename	Bedingt	Nein
   customerlastname	Bedingt	Nein
   customersuffixname	Bedingt	Nein
   customerpremise	Bedingt	Nein
   customertown	Bedingt	Nein
   customercountryiso2a	Bedingt	Nein
   customerpostcode	Bedingt	Nein
   customercounty	Bedingt	Nein	Der für die Lieferadresse eingegebene Bezirk. Auf Seiten mit US-Lokalisierung wird dies als "State code (z. B. NY)" angezeigt, auf anderen Konfigurationen als "County". Bei US-Adressen wird der Bundesstaat in dieses Feld eingegeben. Gültige Formate: Bevorzugt: Zweistelliger Staatencode, z. B. "NY". Vollständiger Name des Staates (keine Abkürzungen), z. B. "New York". Erforderlich, wenn customercountryiso2a eine der folgenden Angaben ist: AR, BR, CA, CN, ID, IN, IT, JP, MX, TH, US
   orderreference	Nein	Nein	Wenn Sie das Feld Bestellreferenz übermitteln, wird der Wert dieses Feldes als Rechnungs-ID an PayPal gesendet. PayPal prüft auf doppelte Rechnungs-IDs, stellen Sie also bitte sicher, dass jede in der POST übermittelte Bestellreferenz für jede Transaktion eindeutig ist. Hinweis: Sie können Ihr PayPal Konto so konfigurieren, dass die Prüfung auf doppelte Rechnungsnummern deaktiviert wird. Wenden Sie sich für weitere Informationen an den PayPal Support. 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.
   paypaladdressoverride	Nein	Nein	Standardmäßig wählt der Kunde seine Lieferadresse aus seinem PayPal Konto aus. Alternativ kann der Kunde auch die auf Ihrer Website eingegebene Adresse verwenden. Dieses Verhalten wird durch Senden des Feldes paypaladdressoverride Feld im anfänglichen POST an die Payment Pages gesendet wird: 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).
   paypallocaleiso2a	Nein	Nein	Verwenden Sie dieses Feld, um den auf der PayPal Kasse angezeigten Inhalt zu lokalisieren. Eine vollständige Liste der unterstützten Werte, die in diesem Feld eingegeben werden können (z. B. paypallocaleiso2a=GB für Großbritannien), finden Sie in der Dokumentation PayPal (Link zu externer Seite).
   ruleidentifier	Nein	Nein	Wenn Ihr POST an Payment Pages bereits alle für die Zahlungsmethode erforderlichen Felder enthält, können Sie den Checkout-Prozess für den Kunden vereinfachen, indem Sie auch ruleidentifier=STR-14 übermitteln. Dadurch kann der Browser des Kunden sofort auf die von der Zahlungsmethode bereitgestellten Seiten gehen, um die Transaktion abzuschließen. (Wir bezeichnen dies als Journey C) Klicken Sie hier, um mehr über die verschiedenen Reisen zu erfahren.

Benachrichtigungen

Sobald eine Zahlung genehmigt wurde, wird der Betrag zu einem späteren Zeitpunkt, der von PayPal festgelegt wird, überwiesen.

Bevor Sie mit dem Testen beginnen, empfehlen wir Ihnen, sich mit unserem Support-Team in Verbindung zu setzen und zu beantragen, dass in Ihrem Konto Regeln aktiviert werden, die URL-Benachrichtigungen in den folgenden Szenarien an Ihr System übermittelt:

• Wenn eine Zahlung genehmigt wird.
• Wenn die Gelder abgewickelt sind.

Konfigurieren der Benachrichtigung Autorisierung

Wir empfehlen, mindestens die folgenden Felder in Ihre Autorisierung Meldung aufzunehmen:

• Autorisierungscode (authcode)
• Grundbetrag (baseamount) (z. B. €10,50 ist "1050")*
• Hauptbetrag (mainamount) (z.B. €10,50 ist "10.50")*
• Rechnungsland (billingcountryiso2a)
• Währung (currencyiso3a)
• Fehlercode (errorcode)
• Live-Status (livestatus)
• Auftragsnummer (orderreference)
• Zahlungsart (paymenttypedescription)
• PayPal E-Mail (paypalemail)
• PayPal Zahler-ID (paypalpayerid)
• Anforderungstyp (requesttypedescription)
• Abrechnungsstatus (settlestatus)
• Website-Referenz (sitereference)
• Transaktionsnummer (transactionreference)
• Zeitstempel Transaktionsstart (transactionstartedtimestamp)

*Bitte wählen Sie Ihr bevorzugtes Format.

Konfigurieren der Benachrichtigung Abrechnung

Wir empfehlen, die folgenden Felder in Ihre Abrechnung Meldung aufzunehmen:

• Abrechnungsstatus (settlestatus)
• Website-Referenz (sitereference)
• Transaktionsnummer (transactionreference)

Prüfen Sie die Benachrichtigung

Sie müssen den Inhalt jeder erhaltenen Meldung prüfen und entsprechend reagieren, indem Sie die in unseren URL-Benachrichtigungen Dokumentation beschrieben sind. Insbesondere müssen Sie auf den aktualisierten settlestatus Wert:

• Auf Genehmigung: Wenn die settlestatus auf "0", "1" oder "10" steht, wurde die Zahlung genehmigt und Sie müssen zu diesem Zeitpunkt keine weiteren Maßnahmen nehmen. Werte von "2" oder "3" bedeuten jedoch, dass die Gelder nicht zur Abrechnung vorgesehen sind (ausgesetzt bzw. storniert)
• Auf Abrechnung: Wenn die settlestatus auf "100" aktualisiert wurde, bedeutet dies, dass der Betrag beglichen wurde. Wenn der Wert auf "3" aktualisiert wurde, bedeutet dies, dass ein Problem aufgetreten ist und die Zahlung daraufhin storniert wurde.

Prüfung

Sie müssen Ihre Lösung testen, bevor Sie mit der Verarbeitung von Live-Zahlungen beginnen können. Testtransaktionen werden über Ihre Testlösung verarbeitet. Website-Referenz.

Wenn Sie Testtransaktionen durchführen, wird Ihr Browser auf unsere simulierte PayPal Kassenseite umgeleitet. Folgen Sie den Anweisungen auf dem Bildschirm, um die Zahlung abzuschließen. Danach werden Sie wieder auf die Seite Payment Pages umgeleitet.

Rückerstattungen

Nach der Bearbeitung einer Zahlung ist es möglich, dem Kunden über MyST eine Rückerstattung zu gewähren.

Standardmäßige PayPal-Erstattungen werden sofort abgewickelt (settlestatus "100"). Unter bestimmten, von PayPal festgelegten Bedingungen können Erstattungen jedoch auf settlestatus "10" ("Settling") gesetzt werden, was ein Zwischenschritt vor Abrechnung ist.

Voraussetzungen

• Sie können eine Zahlung erst dann erstatten, wenn die AUTH abgerechnet wurde (settlestatus ist "100").
• Sie können keinen höheren Betrag erstatten als ursprünglich abgerechnet wurde.