Manche Webentwickler möchten ihren eigenen Warenkorb in den PayPal-Zahlungsablauf integrieren, statt den Standard-PayPal-Warenkorb zu verwenden. Bitte verwenden Sie die Anweisungen unten, um Ihren Käufern zu ermöglichen, über PayPal zu bezahlen, wenn sie alle Artikel in den Warenkorb des Drittanbieters gelegt haben und sie bezahlen möchten.
Es gibt nun zwei Möglichkeiten, wie Sie Ihren Warenkorb eines Drittanbieters in den PayPal-Zahlungsfluss integrieren können. Die erste Möglichkeit besteht darin, den Gesamtbetrag des Warenkorbs statt die einzelnen Artikel weiterzugeben. Die zweite Möglichkeit ist, Details der ausgewählten Artikel statt den Gesamtbetrag des Warenkorbs an PayPal weiterzugeben. Hinweis: Wenn Sie die erforderlichen Variablen an PayPal senden, wie unten beschrieben, ist es wahrscheinlich notwendig, dass Sie Skripting auf Ihrer Website einsetzen.
Methode 1. Gesamten Warenkorbbetrag an PayPal weitergeben |
|
Wenn Sie möchten, können Sie alle Artikel im Warenkorb ansammeln und den Gesamtbetrag an den Code der
Jetzt kaufen-Schaltfläche weiterleiten (d.h. Sie müssen einen einzelnen Namen für den gesamten Warenkorb sowie den Gesamtpreis des Inhalts angeben, als wäre es ein Kauf eines einzelnen Artikels).
Ein Nachteil dieser Methode ist, dass Ihre Käufer nicht sehen können, dass die einzelnen Artikel in den Warenkorb gelegt werden. Außerdem können Sie unsere Variablennamen nicht ändern oder eigene hinzufügen.
Wenn Sie nach dem Durchlesen der Informationen unten noch weitere technische Fragen haben, finden Sie Hilfe in unserem
Entwicklersupport. Weitere Informationen über den Code für die Schaltflächen "Jetzt kaufen" oder über die Variablen unten finden Sie im
Integrationsleitfaden für Websitezahlungslösungen.
Erforderliche VariablenDer Code für Ihre PayPal-Transaktion erfordert die 4 folgenden verborgenen Variablen und ein Bild zum Senden des Formulars:
| Erforderliche Variablen | | Name | Wert | | business | E-Mail-Adresse Ihres PayPal-Kontos | | item_name | Name des Artikels (oder ein Name für den Warenkorb) | | currency_code | Legt die Währung fest, die für die monetären Variablen (amount, shipping, shipping2, handling, tax) gilt. Mögliche Werte sind "USD", "EUR", "GBP", "CAD", "JPY". | | amount | Preis des Artikels (Gesamtpreis aller Artikel im Warenkorb) | | image | Das Bild der Schaltfläche, auf die Ihre Käufer klicken müssen, um den Zahlungsprozess mit PayPal zu starten. Sie können Ihr eigenes Bild einfügen, indem Sie "scr" durch die URL Ihres Bildes ersetzen. |
|
Das heisst, dass der Mindestcode für Ihre Transaktion zu PayPal wie folgt aussieht:
<form action="https://www.paypal.com/de/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_xclick">
<input type="hidden" name="business" value="you@youremail.com">
<input type="hidden" name="item_name" value="Item Name">
<input type="hidden" name="currency_code" value="USD">
<input type="hidden" name="amount" value="0,00">
<input type="image" src="http://www.paypal.com/de_DE/i/btn/x-click-but01.gif" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
</form>
|
|
Bei PayPal gibt es zusätzliche Variablen, mit denen Sie Ihr Formular individuell erstellen können. Alle verfügbaren Variablen sind unten aufgelistet (Variablennamen müssen kleingeschrieben sein):
| Verfügbare Variablen | | Name | Wert | | business | E-Mail-Adresse Ihres PayPal-Kontos | | quantity | Anzahl von Artikeln: Vervielfacht den Betrag, wenn größer als 1 | | item_name | Name des Artikels (oder ein Name für den Warenkorb). Muss alphanumerisch sein, höchstens 127 Zeichen | | item_number | Optional: Durchlaufvariable, um Zahlungen nachverfolgen zu können. Muss alphanumerisch sein, höchstens 127 Zeichen | | amount | Preis des Artikels (Gesamtpreis aller Artikel im Warenkorb) | | shipping | Kosten für den Versand des Artikels | | shipping2 | Kosten für den Versand pro zusätzlichem Artikel | | handling | Abwicklungskosten | | tax | Transaktionsbasierter Steuerwert. Wenn vorhanden, hebt der hier angegebene Wert jede Einstellung zu Steuern in Ihrem Profil auf (unabhängig vom Wohnort des Käufers). | | no_shipping | Lieferadresse. Bei der Einstellung "1" wird der Kunde nicht nach einer Lieferadresse gefragt. Optional; wenn ausgelassen oder auf "0", wird der Kunde dazu aufgefordert, eine Lieferadresse anzugeben. | | cn | Optionales Etikett, das über dem Hinweisfeld angezeigt wird (höchstens 40 Zeichen) | | no_note | Fügt der Zahlung eine Anmerkung hinzu. Bei der Einstellung "1" wird der Kunde nicht dazu aufgefordert, eine Anmerkung hinzuzufügen. Optional; wenn ausgelassen oder auf "0", wird der Kunde dazu aufgefordert, eine Anmerkung hinzuzufügen. | | on0 | Name des ersten Optionsfelds. Höchstens 64 Zeichen | | os0 | Erste(r) Optionswert(e). Höchstens 200 Zeichen "on0" muss definiert sein, damit "os0" erkannt wird. | | on1 | Name des zweiten Optionsfelds. Höchstens 64 Zeichen | | os1 | Zweite(r) Optionswert(e)satz. Höchstens 200 Zeichen. "on1" muss definiert sein, damit "os1" erkannt wird. | | custom | Optionale Durchlaufvariable, die niemals Ihren Kunden gezeigt wird. Zur Nachverfolgung Ihres Bestands | | invoice | Optionale Durchlaufvariable, die niemals Ihren Kunden gezeigt wird. Zur Nachverfolgung von Rechnungsnummern | | notify_url | Nur verwendet mit sofortiger Zahlungsbestätigung. Die Internet-URL, an die Formulare zur sofortigen Zahlungsbestätigung gesendet werden | | return | Die Internet-URL, zu der Ihr Kunde nach Beenden der Zahlung geleitet wird | | cancel_return | Die Internet-URL, zu der Ihr Kunde nach Abbrechen der Zahlung geleitet wird | | image_url | Die Internet-URL des Bildes (150 X 50 Pixel), das Sie als Ihr Logo verwenden möchten | | cs | Legt die Hintergrundfarbe Ihrer Zahlungsseiten fest. Bei "1" ist die Hintergrundfarbe schwarz. Optional; wenn ausgelassen oder auf "0", ist die Hintergrundfarbe weiß |
|
Erweiterte VariablenMit PayPal können Sie
erweiterte Variablen verwenden, wenn Sie die folgende Eingabe "cmd" ändern:
| <input type="hidden" name="cmd" value="_xclick"> |
|
in:
<input type="hidden" name="cmd" value="_ext-enter">
<input type="hidden" name="redirect_cmd" value="_xclick"> |
|
Die oben genannten Änderungen in der Eingabe "cmd" können Sie auch mit den untenstehenden Variablen vornehmen:
| Erweiterte Variablen | | Name | Wert | | email | E-Mail-Adresse des Kunden | | first_name | Vorname des Kunden. Muss alphanumerisch sein, höchstens 32 Zeichen | | last_name | Nachname des Kunden. Muss alphanumerisch sein, höchstens 64 Zeichen | | address1 | Erste Zeile der Kundenadresse. Muss alphanumerisch sein, höchstens 100 Zeichen | | address2 | Zweite Zeile der Kundenadresse. Muss alphanumerisch sein, höchstens 100 Zeichen | | city | Ort der Kundenadresse. Muss alphanumerisch sein, höchstens 100 Zeichen | | state | Staat der Kundenadresse. Offizielle Abkürzung aus zwei Buchstaben | | zip | PLZ der Kundenadresse | | night_phone_a | Vorwahl der Telefonnummer, unter der der Kunde abends zu erreichen ist | | night_phone_b | Die ersten drei Stellen der Telefonnummer, unter der der Kunde abends zu erreichen ist | | | | day_phone_a | Vorwahl der Telefonnummer, unter der der Kunde tagsüber zu erreichen ist | | day_phone_b | Die ersten drei Stellen der Telefonnummer, unter der der Kunde tagsüber zu erreichen ist | | |
|
Hinweis: Um Beträge für Versandkosten festzulegen, die von den Standard-Versandkostenbeträgen in Ihrem Profil abweichen, wechseln Sie zu Ihrem Profil, nehmen Sie die Änderungen in Ihren Versandberechnungen vor, und aktivieren Sie das Kontrollkästchen "Transaktionsbasierte Versandkostenaufhebung".
Methode 2. Einzelartikel an PayPal weitergeben |
|
Wenn Ihr Warenkorb eines Drittanbieters so konfiguriert werden kann, dass Einzelartikel an PayPal weitergegeben werden können, sind Informationen über die Artikel in den Kontoauszügen und Benachrichtigungen der Käufer und Verkäufer zu finden. Um Informationen über die Artikel einzubinden, senden Sie HTML-Elemente an eine neue Version des Flussdiagramms des Warenkorbs von PayPal. Dieser Vorgang läuft ähnlich ab wie unter Abschnitt Nr.1, "Gesamten Warenkorbbetrag an PayPal weitergeben", beschrieben, mit folgenden Unterschieden:
- Setzen Sie die Variable "cmd" auf "_cart"
Ersetzen Sie diese erforderliche HTML-Zeile.
| <input type="hidden" name="cmd" value="_xclick"> |
|
mit
| <input type="hidden" name="cmd" value="_cart"> |
|
- Fügen Sie eine neue Variable "upload" hinzu.
Fügen Sie die folgende Zeile zwischen den Tags <form> und </form> hinzu:
| <input type="hidden" name="upload" value="1"> |
|
- Definieren Sie Artikeldetails
Definieren Sie für jeden der folgenden artikelspezifischen Parameter neue Werte, die mit jedem der Artikel übereinstimmen, die über Ihren Warenkorb eines Drittanbieters erworben wurden. Hängen Sie "_x" an den Variablennamen an, wobei x die Anzahl der Artikel ist, die mit 1 beginnt und mit jedem hinzugefügten Artikel um 1 ansteigt.
| Name | Wert | | item_name_x | (Erforderlich für Artikel Nr. x) Name des Artikels Nr. x im Warenkorb. Muss alphanumerisch sein, höchstens 127 Zeichen | | item_number_x | Optionale Durchlaufvariable zugehörig zu Artikel Nr. x im Warenkorb. Muss alphanumerisch sein, höchstens 127 Zeichen | | amount_x | (Erforderlich für Artikel Nr. x) Preis des Artikels Nr. x | | shipping_x | Die Versandkosten des ersten Stücks (Menge 1) des Artikels Nr. x | | shipping2_x | Die Versandkosten eines jeden zusätzlichen Stücks (Menge mindestens 2) des Artikels Nr. x | | handling_x | Abwicklungskosten für Artikel Nr. x | | on0_x | Name des ersten Optionsfelds für den Artikel Nr. x. Höchstens 64 Zeichen | | os0_x | Erste(r) Optionswert(e) für den Artikel Nr. x. Höchstens 200 Zeichen. "on0_x" muss definiert sein, damit "os0_x" erkannt wird. | | on1_x | Name des zweiten Optionsfelds für den Artikel Nr. x. Höchstens 64 Zeichen | | os1_x | Zweiter Optionswertsatz für den Artikel Nr. x. Höchstens 200 Zeichen. "on1_x" muss definiert sein, damit "os1_x" erkannt wird. |
|
- Wiederholen Sie dies für jeden Artikel im Warenkorb.
IGeben Sie die erforderlichen Variablen sowie etwaige optionale Variablen aus der Tabelle für jeden Artikel im Warenkorb Ihres Käufers an. Der erste Artikel im Warenkorb sollte mit Parametern definiert werden, die auf "_1" enden, wie "item_name_1", "amount_1" usw. Auf die gleiche Weise sollte der zweite Artikel mit Variablen wie "item_name_2", "amount_2" usw. benannt werden. Hinweis: Die "_x"-Werte müssen kontinuierlich um 1 ansteigen, um erkannt zu werden. Wenn Sie von Artikel Nr. 1 zu Nr. 3 springen, ohne einen Artikel mit der Nr. 2 zu definieren, wird der dritte Artikel ignoriert.
So legen Sie die Währung fest: Alle monetären Variablen (amount, shipping, shipping2, handling, tax) werden in der Währung angesehen, die durch die Variable "currency_code" festgelegt und mit der Zahlung versendet wird. Da es nicht artikelspezifisch ist, ist es nicht erforderlich, ein "_x" an den Variablennamen anzuhängen. Wenn keine Variable "currency_code" angegeben wird, gehen wir davon aus, dass alle monetären Werte in US-Dollar angegeben sind.
Wenn Sie nach dem Durchlesen der Informationen unten noch weitere technische Fragen haben, finden Sie Hilfe in unserem
Entwicklersupport. Weitere Informationen über den Warenkorb oder die unten stehenden Variablen finden Sie im
Integrationsleitfaden für Websitezahlungslösungen.
