Customer Documentation

Zahlungsmethode PayPal (alte Version) einrichten

Diese Version der PayPal Schnittstelle ist veraltet, die Dokumentation betrifft nur alte, bereits bestehende, Integrationen. Diese Version wird ab 2027 nicht mehr unterstützt und wird entfernt.

Nutzen Sie für neue Einrichtungen die neue Schnittstelle: https://cobai.atlassian.net/wiki/pages/resumedraft.action?draftId=741212161&draftShareId=01b4e0b0-30d7-4b00-a7cd-2ec7c96d8b63

Zahlungsmethode "PayPal" (legacy) einrichten

Um die Zahlungsmethode PayPal einzurichten gehen Sie wie folgt vor:

  1. Bei PayPal registrieren. (Wenn Sie bereits Mitglied bei PayPal sind können Sie diesen Schritt überspringen).

  2. API-Berechtigungen anfordern.

  3. Konfiguration im Shop vornehmen

  4. Sofortige Zahlungsbestätigung aktivieren.

Bei PayPal registrieren

Besuchen Sie https://www.paypal.de und erstellen Sie ein Konto für Geschäftskunden. Falls Sie Probleme bei der Erstellung des Kontos haben, konsultieren Sie die Hilfe.

API-Berechtigung anfordern

Damit der Shop mit PayPal kommunizieren kann, braucht er sogenannte "API-Berechtigungen". Der Begriff API (Application Programming Interface) bedeutet in diesem Fall "Schnittstelle".

  • Loggen Sie sich bei PayPal ein. Wählen Sie den Menüpunkt "Mein Profil" und dann "Kontoeinstellungen". Klicken Sie auf "Verkäufer/Händler" und wählen Sie den Punkt "API-Zugriff".

  • Klicken Sie unter "NVP/SOAP-API-Integration" auf "API-Berechtigung anfordern". Sollte "API-Signatur anzeigen" zu sehen sein, haben Sie bereits zu einem früheren Zeitpunkt API-Berechtigungen angefordert. In diesem Fall können Sie den nächsten Schritt überspringen.

  • Stellen Sie sicher, dass der Punkt "Fordern Sie eine API-Signatur an" ausgewählt ist. Klicken Sie dann auf "Zustimmen und senden".

  • Sie sehen nun die von Paypal erstellten Daten. Die drei Felder "API-Benutzername", "API-Passwort" und "Signatur" müssen in der Konfiguration Ihres Shops eingetragen werden.

Einen Nummernkreis für Aufträge anlegen

Für die ordnungsgemäße Zuordnung von Zahlungen zu Aufträgen benötigt der Shop für jeden Auftrag eine Auftragsnummer. Damit Auftragsnummern vergeben werden müssen Sie einen Nummernkreis für Aufträge anlegen. Gehen Sie wie folgt vor:

  1. Melden Sie sich als Shopbetreiber am Shop an.

  2. Rufen Sie die "Einstellungen"-Seite auf, indem Sie rechts oben im opCenter auf "Einstellungen" klicken.

  3. Wählen Sie den Menüpunkt "Nummernkreise" aus.

  4. Prüfen Sie, ob es bereits einen Nummernkreis mit dem Namen "AUFTRAG" gibt. Wenn nein führen Sie die folgenden Aktionen aus:

    1. Tragen Sie in das Eingabefeld das Wort "AUFTRAG" (ohne Anführungszeichen, nur Grossbuchstaben) ein.

    2. Drücken Sie die Eingabetaste.

    3. Tragen Sie in die daraufhin erscheinenden Felder einen Startwert, den aktuellen Stand sowie einen Maximalwert für Auftragsnummern ein, wie in der untenstehenden Abbildung. Startwert und aktueller Stand müssen den gleichen Wert haben.

API-Berechtigung im Shop eintragen

Um die Daten Ihres Projektes im Shop zu hinterlegen gehen Sie wie folgt vor:

  1. Melden Sie sich als Shopbetreiber am Shop an.

  2. Rufen Sie die "Einstellungen"-Seite auf, indem Sie rechts oben im opCenter auf "Einstellungen" klicken. Wählen Sie den Menüpunkt "Zahlungsbedingungen" aus.

  3. Klicken Sie in der Zeile "Paypal" auf den Link "konfigurieren"

  4. Tragen Sie die von Paypal erhaltenen Daten in die Felder "Benutzername", "Passwort" und "Signatur" ein.

Sofortige Zahlungsbestätigung aktivieren

  • Loggen Sie sich bei PayPal ein. Wählen Sie den Menüpunkt "Mein Profil" und dann "Kontoeinstellungen". Klicken Sie auf "Verkäufer/Händler" und wählen Sie den Punkt "Benachrichtigungen über Sofortzahlungen".

  • Klicken Sie auf "Einstellungen für sofortige Zahlungsbestätigungen wählen".

  • Tragen Sie in das Feld "Benachrichtigungs-URL" die Adresse Ihres Shops, gefolgt von /storefront/paypalIpn.html ein. Wenn Ihr Shop z. B. unter der Adresse http://mein-shop.mycobai.com zu erreichen ist tragen Sie http://mein-shop.mycobai.com/storefront/paypalIpn.html als Benachrichtigungs-URL ein.

  • Aktivieren Sie "Sofortige Zahlungsbestätigungen erhalten (aktiviert)"

  • Klicken Sie auf speichern

Achtung

Die Benachrichtigungs-URL enthält Zeichen die leicht verwechselt werden können (ein kleines "L", gefolgt von einem grossen "i" in paypalIpn). Achten Sie darauf, die URL genau so einzugeben. Die Gross-/Kleinschreibung ist an dieser Stelle wichtig.