Voraussetzung
- Das angebundene Anzeigensystem muss die Zahlart "PayPal" besitzen und verarbeiten können.
- Das Anzeigensystem /wiki/spaces/CON/pages/221086726 hat hierfür die Zahlart "PayPal" mit dem Schlüssel "40120". (siehe 108.sdv)
- Man muss im Besitz eines geschäftlichen PayPal-Accounts sein*
*Ein geschäftlicher Account unter https://www.sandbox.paypal.com/ kann hierfür nicht verwendet werden! Es muss ein "echter", geschäftlicher Account bei https://www.paypal.com/ sein, da nur diese auch Developer-Accounts sind/sein können, über die man REST-API-Credentials generieren kann, die man für WebAnzeigen benötigt.
Einrichtung
PayPal
PayPal-REST-API-Credentials für WebAnzeigen erzeugen:
- https://developer.paypal.com/dashboard/applications/ aufrufen und mit dem geschäftlichen PayPal-Account anmelden
- Unter "Sandbox" (= Test) oder "Live" den Button "Create App" klicken und folgende Daten hinterlegen/auswählen:
- "App Name" eingeben (z.B. "WebAnzeigen")
- "App Type" = "Merchant" wählen (steht nur bei Typ "Sandbox" zur Auswahl)
- "Sandbox Business Account" auswählen (steht nur bei Typ "Sandbox" zur Auswahl, bei "Live" erstellt man die Credentials automatisch für den echten, geschäftlichen PayPal-Account)
- "Create App" klicken
- Auf der sich danach öffnenden Seite aus dem Block "SANDBOX API CREDENTIALS" die Werte von "Client ID" und "Secret" abspeichern. Diese werden in der WebAnzeigen-Konfig benötigt.
WebAnzeigen
- Zahlarten ggfs. erneut per Job (LoadBaseData) in die WebAnzeigen-DB übertragen.
- Der webanzeigen-interne Key (ID_SDV_REC) bei den Zahlarten (ID_SDV = 7011) für PayPal ist "7011070". Dieser muss existieren und diesem der Schlüssel der Zahlart PayPal aus dem Anzeigensystem zugeordnet werden (VALUE4).
- In der app.properties der Weberfassung (Anwendung "webanz") müssen folgende Konfigeinträge hinterlegt werden:
- paypal.enabled = 1 (default ist 0/aus)
- paypal.api.baseUrl = <https://api.sandbox.paypal.com für Test | https://api-m.paypal.com für Produktion>
- paypal.api.user = <REST-API-Credential-Client ID>
- paypal.api.password = <REST-API-Credential-Secret>
Weitere Informationen
- Aufträge, die per PayPal bezahlt wurden, können nicht geändert oder storniert werden, da das Geld sofort (wie bei einer Barzahlung) überwiesen wird.
- Wird die Zahlart PayPal gewählt, so wird die Rechnungsart am Auftragkunden automatisch auf Auftragsrechnung gestellt. Bei Zahlart Lastschrift wird, wie bisher, die Rechnungsart Einzelrechnung gesetzt.
- Im Admintool sieht man unterhalb der Nutzung und Zahlart den "PayPal-Transaktionscode", damit man die Zahlung zum Auftrag in PayPal wiederfindet.
- Der Transaktionscode wird nach VL-Anzeigen übertragen. Hierfür wurde das neue Attribut „PayPalTransactionCode“ am Auftragkunden eingeführt. Standardmäßig wird das Attribut in der UI der Auftragsbearbeitung nicht angezeigt. Wenn erforderlich, kann dies mittels einer kundenspezifischen Auftragsmaske konfiguriert werden. Zum Test kann in der Auftragsbearbeitung für den geöffneten Auftrag über das Kürzel Strg+Shift+Alt+X die Auftragsdaten als XML-angezeigt werden.
- Bei jeder PayPal-Zahlung über WebAnzeigen wird die Auftragsnummer in den "Bestelldetails" (Verkäufer) bzw. "Kaufdetails" (Kunde) der PayPal-Transaktion hinterlegt, um zu erkennen, dass und für welchen Anzeigenauftrag diese Zahlung erfolgte.