PayPal-Zahlungen annehmen

Stripe übermittelt ein payment_intent.succeeded-Ereignis, wenn die Zahlung abgeschlossen ist. Verwenden Sie im Dashboard einen Webhook oder eine Partnerlösung, um diese Ereignisse zu empfangen und Aktionen auszuführen (Versenden einer Bestellbestätigung per E-Mail an die Kund/innen, Erfassen des Verkaufs in einer Datenbank oder Einleiten des Versandablaufs).

Überwachen Sie diese Ereignisse, statt auf einen Callback vom Client zu warten. Auf dem Client könnte der Kunde/die Kundin das Browserfenster schließen oder die App beenden, bevor der Callback erfolgt ist und böswillige Clients könnten die Antwort manipulieren. Wenn Sie Ihre Integration so einrichten, dass asynchrone Ereignisse überwacht werden, hilft Ihnen dies auch dabei, in Zukunft mehr Zahlungsmethoden zu akzeptieren. Hier erhalten Sie Informationen zu den Unterschieden zwischen allen unterstützten Zahlungsmethoden.

Ereignisse empfangen und Geschäftsaktionen ausführen

Es gibt mehrere Möglichkeiten, Geschäftsaktionen zu empfangen und auszuführen.

Manuell

Verwenden Sie das Stripe-Dashboard, um alle Stripe-Zahlungen anzuzeigen, Zahlungsbelege per E-Mail zu senden, Auszahlungen abzuwickeln oder fehlgeschlagene Zahlungen erneut durchzuführen.

• Testzahlungen im Dashboard anzeigen

Benutzerdefinierter Code

Erstellen Sie einen Webhook-Handler, um Ereignisse zu überwachen und benutzerdefinierte asynchrone Zahlungsabläufe zu erstellen. Mit der Stripe-CLI können Sie Ihre Webhook-Integration lokal testen und Fehler beheben.

• Nutzerdefinierten Webhook erstellen

Vorgefertigte Apps

Verarbeiten Sie häufige Geschäftsereignisse, wie Automatisierung oder Marketing und Vertrieb durch Integration einer Partneranwendung.

Wenn Sie Stripe.js verwenden, können Sie Ihre Integration einfacher um weitere Zahlungsmethoden erweitern. Sie können Ihre Kundinnen und Kunden jedoch auch manuell an Ihren Server weiterleiten.

1. Erstellen und bestätigen Sie einen PaymentIntent vom Typ paypal. Durch Angabe von payment_method_data wird eine PaymentMethod erstellt und sofort mit dem PaymentIntent verwendet.

Im Feld return_url müssen Sie auch die URL angeben, an die Ihre Kund/innen nach Abschluss ihrer Zahlung weitergeleitet werden. Sie können Ihre eigenen Abfrageparameter in dieser URL angeben. Diese Parameter werden nach Abschluss der Weiterleitung in die endgültige URL aufgenommen.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=paypal \
  -d "payment_method_data[type]"=paypal \
  --data-urlencode return_url="https://example.com/checkout/complete" \
  -d confirm=true

1. Überprüfen Sie, ob der PaymentIntent den Status requires_action und ob next_action den Typ redirect_to_url hat.

{
  "status": "requires_action",
  "next_action": {
    "type": "redirect_to_url",
    "redirect_to_url": {
      "url": "https://hooks.stripe.com/...",
      "return_url": "https://example.com/checkout/complete"
    }
  },
  "id": "pi_1G1sgdKi6xqXeNtkldRRE6HT",
  "object": "payment_intent",
  ...
}

1. Leiten Sie die Kundinnen/Kunden an die in der Eigenschaft next_action.redirect_to_url.url angegebene URL weiter. Dieses Codebeispiel ist nur eine Annäherung und kann sich vom Weiterleitungsverfahren in Ihrem Web-Framework unterscheiden.

if payment_intent.status == 'requires_action' && payment_intent.next_action.type == 'redirect_to_url'
  url = payment_intent.next_action.redirect_to_url.url
  redirect(url)
end

Bei Abschluss des Bezahlvorgangs werden Ihre Kundinnen/Kunden zu Ihrer return_url weitergeleitet. Die URL-Abfrageparameter payment_intent und payment_intent_client_secret sind zusammen mit Ihren eigenen Abfrageparametern enthalten. Stripe empfiehlt, einen Webhook-Endpoint einzurichten, um den Zahlungsstatus programmgesteuert zu bestätigen.

PayPal unterstützt die separate Autorisierung und Erfassung. Wenn Sie sich für die Zahlungsabwicklung mit Stripe entschieden haben, sind Ihre Autorisierungen 10 Tage lang gültig. Stripe autorisiert die Zahlung automatisch erneut, um den Autorisierungszeitraum um weitere 10 Tage zu verlängern. Dies ergibt eine Gesamtdauer von 20 Tagen. Wenn die erneute Autorisierung nicht funktioniert, lässt Stripe die Zahlung nach 10 Tagen ablaufen. Überwachen Sie den Webhook charge.expired, um zu erfahren, wann der Autorisierungszeitraum endet.

Wenn Sie sich für die Zahlungsabwicklung mit PayPal entschieden haben, bleibt Ihr Autorisierungszeitraum 3 Tage lang gültig. Für einen erweiterten garantierten Autorisierungszeitraum von bis zu 10 Tagen, bei PayPal als honor period bezeichnet, kontaktieren Sie den PayPal-Support.

Stripe anweisen, nur zu autorisieren

Um anzugeben, dass Sie Autorisierung und Erfassung trennen möchten, legen Sie capture_method beim Erstellen des PaymentIntent auf manual fest. Dieser Parameter weist Stripe an, nur den Betrag im PayPal-Konto der Kundin/des Kunden zu autorisieren.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d capture_method=manual \
  -d "payment_method_types[]"=paypal \
  -d "payment_method_data[type]"=paypal \
  -d confirm=true \
  --data-urlencode return_url="http://example.com"

Bei erfolgreicher Autorisierung übermittelt Stripe das Ereignis payment_intent.amount_capturable_updated. Lesen Sie in unserem Leitfaden zu Ereignissen mehr dazu.

Die Gelder erfassen

Nach erfolgreicher Autorisierung wechselt der Status des PaymentIntent zu requires_capture. Um die autorisierten Gelder zu erfassen, führen Sie eine Erfassungsanfrage für den PaymentIntent durch. Standardmäßig wird der gesamte autorisierte Betrag erfasst. Sie können keinen höheren, aber einen niedrigeren Betrag erfassen.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount_to_capture=750

Optional Autorisierung stornieren

Wenn Sie eine Autorisierung stornieren müssen, können Sie den PaymentIntent stornieren.

Standardmäßig lässt Stripe nur synchrone Zahlungsmethoden per PayPal zu. Dadurch wird garantiert, dass Sie über den Erfolg oder das Fehlschlagen einer Zahlung umgehend benachrichtigt werden. Wenn Sie asynchrone Zahlungsmethoden zulassen, erhalten Sie für einige Zahlungen möglicherweise verzögerte Benachrichtigungen. Daher müssen Sie Webhook-Endpoints verwenden, um Benachrichtigungen über den Erfolg oder das Fehlschlagen bestimmter Zahlungen zu erhalten.

Kontaktieren Sie den Stripe-Support, um asynchrone Zahlungen auf PayPal zu aktivieren.

Dies sind die häufigsten Fehlercodes und die dazugehörigen Details bei der Integration mit PayPal. Wenn eine PayPal API-Anfrage den Fehler zurückgegeben hat, enthält sie einen PayPal-Problemcode und die zugehörige Debug-ID für die Anfrage. Sie können die Debug-ID verwenden, wenn Sie sich an den PayPal-Support wenden, um Hilfe bei Ihrem Problem zu erhalten.

Um eine erfolgreiche Zahlung in Ihrer PayPal-Integration zu testen, verwenden Sie Ihre Test-API-Schlüssel und zeigen Sie die Weiterleitungsseite an. Dort sehen Sie die Optionen zum Autorisieren oder Fehlschlagen der Nutzerauthentifizierung als Test-Szenarien. Wenn Sie Testzahlung autorisieren auswählen, geht der PaymentIntent von requires_actionzu succeeded über.

Um den Fall zu testen, in dem Nutzer/innen sich nicht authentifizieren können, verwenden Sie Ihre Test-API-Schlüssel und zeigen Sie die Weiterleitungsseite an. Klicken Sie auf der Weiterleitungsseite auf Fail test payment (Testzahlung fehlschlagen lassen). Der PaymentIntent wechselt dann von requires_action zu requires_payment_method.

Um die häufigsten Integrations- und Fehlerszenarien für Zahlungen mit PayPal zu simulieren, übergeben Sie bei der Erstellung des PaymentIntent als Teil der Abrechnungsdetails email-Werte, die den unter Test-Szenarien beschriebenen Mustern entsprechen. Bei der Bestätigung des PaymentIntent auf der Serverseite würde eine Anfrage, die eine von PayPal abgelehnte Zahlung simuliert, zum Beispiel wie folgt aussehen:

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=paypal \
  -d "payment_method_data[type]"=paypal \
  --data-urlencode "payment_method_data[billing_details][email]"="transaction_refused@example.com"

Test-Szenarien