Was ist PayPal-API?
Eine PayPal-API ist eine Schnittstelle, die als Vermittler zwischen einem Serverprogramm und einem Clientprogramm dient. In unserem Fall handelt es sich bei dem Serverprogramm, das der PayPal-API Drittentwicklern zur Verfügung stellt, um PayPal. Ein Client ist ein Programm, das Entwickler basierend auf der PayPal-API erstellen, um Zahlungen auf einer Website durchzuführen, Verkäufe zu erstatten, Transaktionsdetails abzurufen, einen Abrechnungsplan einzurichten, Kreditkarten-Historie sicher zu speichern, usw. PayPal ist eine REST-API; sie verwendet HTTP-Methoden, um sich einfach in Web- und Mobil-Apps zu integrieren.”>
Wie man PayPal-API-Schlüssel, Zugangsdaten und Signatur erhält
Bitte beachten Sie: Die PayPal-API funktioniert nur mit einem PayPal Premier-, Business- oder Website Payments Pro-Konto. Zunächst müssen Sie in diesem Tutorial ein Geschäftskonto erstellen.
PayPal-Geschäftskonto erstellen
Schritt 1. Registrieren Sie sich bei PayPal.
Schritt 2. Zunächst müssen Sie Angaben zu Ihrer Person machen: Vorname, Nachname, Geschäfts-E-Mail und Passwort. Verwenden Sie ein einzigartiges Passwort für Ihr PayPal-Konto und bewahren Sie es sicher auf. Falls Sie geschäftliche Logins auch über Ihr Smartphone verwalten, ist es außerdem hilfreich zu wissen, wie Sie gespeicherte Passwörter auf dem iPhone finden, falls Sie später Zugriff benötigen.
Schritt 3. Danach sollten Sie die Unternehmensdaten angeben: den rechtlichen Firmennamen, die Telefonnummer und die Adresse.
Beachten Sie bitte, dass PayPal in bestimmten Regionen und Ländern weltweit verfügbar ist.
Sie sind: Alberta, British Columbia, Manitoba, New Brunswick, NewFoundland and Labrador, Northwest Territories, Nova Scotia, Nunavut, Ontario, Prince Edward Island, Quebec, Saskatchewan, Yukon.
Falls Ihr Unternehmen nicht zu einer dieser Provinzen gehört, lesen Sie die PayPal-FAQ für internationale Entwickler. Kurz gesagt: Wenn Sie außerhalb der USA oder Großbritanniens Entwickler sind, können Sie deren NVP/SOAP-APIs verwenden.
Schritt 4. Wählen Sie außerdem Ihre Rechtsform aus den folgenden Optionen: Einzelperson, Einzelunternehmen, Partnerschaft, Kapitalgesellschaft, Privatunternehmen, Börsennotiertes Unternehmen, Gemeinnützige Organisation, Regierungsbehörde.
Beschreiben Sie Ihr Unternehmen detaillierter und beantworten Sie mehrere Fragen:
Klicke auf „Senden“. Dann erzähle etwas über dich.
Schritt 5. Danach wählen Sie den Zweck Ihres PayPal-Kontos. Sie können es verwenden, um Geld zu empfangen oder zu senden, Kunden eine Rechnung zu schicken oder PayPal-Checkout auf der Website anzubieten. Wählen Sie Online-Zahlungen einrichten.Jetzt sind Sie auf dem Weg zu Ihrem PayPal-Schlüssel.
PayPal-API-Zugangsdaten abrufen
Schritt 1. Nachdem Sie ein Geschäftskonto erstellt haben, gehen Sie zur PayPal-Entwicklerseite und melden Sie sich im Dashboard an.
Schritt 2. Nachdem Sie sich angemeldet haben, erhalten Sie einen persönlichen PayPal-API-Schlüssel. Gehen Sie dazu zum Bereich „Meine Apps & Anmeldeinformationen“ und klicken Sie auf „App erstellen“
Schritt 3. Geben Sie einen Anwendungsnamen ein und klicken Sie erneut auf „Erstellen“. Sie erhalten eine Client-ID, den Namen eines Sandbox-Kontos und ein „Geheimnis“.
PayPal API-Signatur oder Zertifikat erhalten
Als Nächstes erzeugen wir entweder PayPal-API-Signaturdaten oder API-Zertifikatsnachweise. Falls Sie unsicher sind, welches Sie wählen sollen, hier erklären wir den Unterschied:
- PayPal-API-Signatur enthält API-Benutzernamen, API-Passwort und Signatur, die nicht ablaufen.
- API-Anmeldedaten umfassen einen API-Benutzernamen bei PayPal, API-Passwort und Zertifikat, die automatisch nach drei Jahren ablaufen.
Beachten Sie, dass Sie für PayPal API-Zugangsdaten eine verifizierte E-Mail-Adresse benötigen.
So erhalten Sie API-Signatur- oder Zertifikatsnachweise für Ihr PayPal-Konto:
- Melden Sie sich bei Ihrem PayPal Sandbox-Konto an, verwenden Sie Ihre Geschäftsprofildaten.
- Klicken Sie auf das Symbol „Einstellungen“.
- Klicken Sie links auf der Seite auf Kontozugang unter „Konto & Sicherheit“.
- Im Abschnitt „API-Zugriff“ klicken Sie auf „Aktualisieren“
- Klicken Sie unter „NVP/SOAP API-Integration“ auf „API-Zugangsdaten verwalten“.
- Wählen Sie eine der folgenden Optionen. API-Signatur anfordern – Auswählen zur Authentifizierung mittels API-Signatur. API-Zertifikat anfordern – Auswählen zur Authentifizierung mittels API-Zertifikat.
- Klicken Sie auf „Zustimmen“ und „Senden“.
- Das war’s! Danach erzeugt PayPal Ihre API-Zugangsdaten.
PayPal-API-Beispiele
PayPal bietet mehrere REST-APIs und unterteilt sie in drei Kategorien:
- Live – sie sind kürzlich veröffentlicht, vollständig unterstützt und für neue Abonnenten verfügbar.
- Begrenzte Veröffentlichung – vollständig unterstützte API, in ausgewählten Märkten verfügbar.
- Veraltet – archivierte, aber vollständig unterstützte APIs.
Nachfolgend finden Sie unsere beliebtesten Beispiele.
Auszahlungs-API
Diese API wird verwendet, um Geld an mehrere PayPal-Empfänger zu senden. Sie eignet sich perfekt für Belohnungen, Rabatte und Provisionen. Die Empfänger müssen ihre E-Mail-Adresse, Mobilnummer oder Payer-ID angeben.
Zahlungs-REST-API
Die am weitesten verbreitete und funktionsstärkste API. Sie wird verwendet, um Zahlungen sicher und reibungslos auf Websites und in Apps zu akzeptieren. Sie ermöglicht es, Zahlungen sofort oder zeitverzögert zu akzeptieren, Details abgeschlossener Transaktionen anzuzeigen und vollständige oder teilweise Rückerstattungen vorzunehmen.
PayPal Express Checkout API
Intelligente PayPal-Zahlungsbuttons bieten Nutzern das relevanteste, einfachste und sicherste Checkout-Erlebnis. Sie können PayPal-Buttons ganz einfach anpassen, und es besteht die Möglichkeit, alternative Zahlungsmethoden wie Venmo oder Kreditkarte hinzuzufügen. Wenn Sie es in Ihre Website oder App integrieren, funktioniert es folgendermaßen: Zunächst erscheint ein Checkout-Popup-Fenster und fordert den Nutzer auf, sich bei PayPal anzumelden. Anschließend wird die Transaktion nach Zahlungsfreigabe durch die PayPal Orders API abgeschlossen.
Abonnements-API
Sie dürfen wiederkehrende PayPal-Zahlungen für physische Güter und Dienstleistungen sowie für digitale Produkte einrichten. Es besteht die Möglichkeit, einen festen Betrag festzulegen und einen gestaffelten Tarifplan zu nutzen.
PayPal Disputes API
Falls ein Problem auf PayPal-Seite auftritt, bietet PayPal an, einen Streitfall zu eröffnen und mit dem Support-Team zu kommunizieren.
PayPal-API für wiederkehrende Zahlungen
Dieses API-Beispiel ist veraltet, wird jedoch von PayPal vollständig unterstützt – auch von Händlern, die es noch verwenden. Die API für wiederkehrende Zahlungen ist ein Analogon zur Subscriptions-API, bietet jedoch weniger Funktionen.
Rechnungs-API
Dieses API-Beispiel ist veraltet, wird jedoch von PayPal vollständig von Händlern unterstützt, die es weiterhin verwenden. Die API für wiederkehrende Zahlungen ist ein Analogon zur Subscriptions-API, bietet aber weniger Funktionen. Um Rechnungszahlungen nachzuverfolgen, können Sie Webhooks verwenden – spezielle HTTP-Callbacks, die Ereignisbenachrichtigungen empfangen.
PayPal bietet einen API-Executor, der Entwicklern das Testen und Integrieren von Produkten vor dem Start ermöglicht. Verwenden Sie ihn, um die Funktionsweise jedes von Ihnen ausgewählten Produkts zu prüfen.
PayPal-Integration auf einer Website
Um einen PayPal-Button auf deiner Website zu integrieren, musst du gleichzeitig die Engineering- und Business-Workflows starten.
Erstellen Sie zuerst Ihre eigene API-Lösung, wie im Artikel beschrieben. Dann richten Sie eine Sandbox ein, testen das Produkt als Entwickler und beantragen ein Live-Konto. Ein Live-Konto integriert alle PayPal-Funktionen. Integrieren und testen Sie das von Ihnen erstellte Produkt. Wenn alles klappt, schließen Sie einen Vertrag für ein Live-Konto ab. Bereiten Sie alles für den Live-Betrieb vor, prüfen Sie sorgfältig und starten Sie schließlich Ihre PayPal-API-basierte Lösung!
PayPal-Schaltfläche von Elfsight. Erstellen Sie einfach ein PayPal-Geschäftskonto und integrieren Sie anschließend einen Button in Ihre Website.
Zu den beliebtesten API-Beispielen gehört PayPal Express Checkout, das NVP- und SOAP-Integrationsmethoden verwendet. Es ist veraltet, und obwohl PayPal es noch unterstützt, setzt die neuere Checkout-API auf neue, erweiterte Funktionen.
PayPal-API-Limits und Preise
Wenn Sie Zahlungen über PayPal erhalten, fällt eine Gebühr in Prozent plus eine feste Gebühr je Währung an. Wenn Sie PayPal verwenden, fallen im Jahr 2020 weder monatliche noch Kündigungsgebühren an. Unten sehen Sie die Kosten von PayPal in verschiedenen Ländern:
| Wenn das Geld, das Sie erhalten, von einem PayPal-Konto stammt: | Sie sollten bezahlen. |
| Kanada | Eine Gebühr von 2,9% des Transaktionsbetrags zuzüglich 0,30 CAD |
| USA | eine Gebühr in Höhe von 3,7 % des Transaktionsbetrags zuzüglich 0,30 USD |
| Europa | Eine Gebühr in Höhe von 3,9% des Transaktionsbetrags zuzüglich €0,35. |
| Russland | eine Gebühr von 3,9 % des Transaktionsbetrags zuzüglich 10 RUB |
| Brasilien | Eine Gebühr von 3,9 % des Transaktionsbetrags zuzüglich 0,60 BRL |
| Mexiko | eine Gebühr in Höhe von 3,9% des Transaktionsbetrags zuzüglich 4,00 MXN |
| Singapur | Eine Gebühr von 3,9% des Transaktionsbetrags zuzüglich 0,50 SGD. |
Schauen Sie sich die vollständige Liste der Länder und Gebühren auf der PayPal Payments Standard-Seite an.
Zum Thema tägliche Grenzwerte, wie oft Sie die PayPal-API aufrufen können: Sie können so viele Anfragen senden, wie Sie möchten. Wir empfehlen jedoch, API-Aufrufe nicht zu häufig zu tätigen.
PayPal-Dokumentation
Die PayPal-API-Dokumentation ist sehr umfangreich, da sie weltweite Zahlungsprozesse beschreibt. Um damit zu arbeiten, wählen Sie zunächst einen Kontotyp: Entwickler, Privat- oder Geschäftskonto. Wählen Sie anschließend die API-Art, die Sie im Projekt verwenden möchten (wir haben sie zuvor aufgelistet). Finden Sie dann eine Seite mit der benötigten API-Art, studieren Sie die von PayPal angebotenen Methoden und Objekte und testen Sie abschließend, was Sie in der Entwickler-Sandbox erhalten.
PayPal-API-Änderungen
PayPal hat mehrere API-Typen abgekündigt, unterstützt sie jedoch weiterhin. Sich mit den zahlreichen Änderungen der PayPal-API vertraut zu machen, kann beim Verständnis des Integrationsprozesses auf einer Website hilfreich sein.
2018-Änderungen: Die horizontale Button-Anordnung wurde standardmäßig eingeführt; Die Codebeispiele der Payouts-API-Integration wurden aktualisiert; Die empfohlenen und Standard-Bezeichnungen für den kleinen Smart Payment Button wurden entfernt.
2019-Änderung: Code-Beispiele wurden zu den Währungsumrechnungsfunktionen hinzugefügt, ebenso eine Liste der ausgeschlossenen Länder.
Änderung 2020: Die Abwicklung wiederkehrender Zahlungen wurde aktualisiert. Benutzer müssen nun wiederkehrende Zahlungen erstellen, statt bis zu zehn Zahlungen gleichzeitig.
FAQ
Sollte ich mich als Entwickler registrieren, wenn ich ohne Anmeldung auf die Sandbox zugreifen kann?
Es ist nicht zwingend nötig. Aber falls Sie Zugriff auf einige wirklich coole Funktionen wünschen – etwa das Erstellen eines vorkonfigurierten Testkontos, den Zugriff auf REST-API-Anmeldeinformationen und das Transaktions-Dashboard – sollten Sie es nutzen.
Ist es möglich, die Transaktionshistorie über die NVP/SOAP-APIs wiederherzustellen, wenn ich derzeit die REST-API nutze?
Leider nein. Speziell für diesen Fall haben PayPal-Entwickler die TransactionSearch-API eingeführt.
Sollen Texte leer bleiben, wenn Werte optional sind?
Der Handler sollte nicht mit leeren Zeichenketten stehen bleiben; wenn du optionale Felder nicht ausfüllen möchtest, füge sie einfach nicht hinzu.
Werden alle PayPal NVP/SOAP-APIs auf REST aktualisiert?
PayPal verbessert derzeit seine Dienste, und NVP-APIs, die zur älteren Generation gehören, werden bald aktualisiert.
Fazit
Das Lesen der PayPal-Dokumentation kann Stunden dauern, weil Sie den Prozess der Annahme und Abwicklung von Zahlungen über Ihre Website oder App organisieren müssen. Ein weiteres Problem ist, dass PayPal derzeit von älteren NVP/SOAP-APIs auf die REST-API umstellt, was doppelt so viel Dokumentation bedeutet wie zuvor.
Heute ist es möglich, eine einfach anpassbare Elfsight PayPal-Schaltfläche auf einer Website zu integrieren – ohne Programmierung und ohne endlose Dokumentationsseiten zu lesen. Registrieren Sie einfach Ihr Geschäftskonto auf der PayPal-Website – der Vorgang ist in unserem Tutorial beschrieben – und erstellen Sie das Widget mit großartiger Funktionalität. Jetzt ausprobieren!
