Serverseitige Integration

Stripe empfiehlt, für alle POST-Anfragen einen Idempotenz-Schlüssel hinzuzufügen. Stellen Sie sicher, dass es sich bei dem Schlüssel um eine eindeutige Kennung handelt, wie einen Universally Unique Identifier (UUID) oder eine Kombination aus Kunden- und Bestell-ID. Mit diesen Schlüsseln sollte es Ihnen möglich sein, Wiederholungsanfragen bei Auftreten von Netzwerkfehlern auf sichere Weise auszuführen.

Customer-Objekte: Zahlungsdetails werden gespeichert

Um PaymentMethods zu speichern und wiederzuverwenden, müssen Sie sie an Customer-Objekte anhängen.

Speichern Sie nach dem Anhängen der PaymentMethod an eine Kundin/einen Kunden die Customer-ID und PaymentMethod-ID in Ihrem System, um sie für zukünftige Zahlungen zu verwenden. Da ein Customer-Objekt eine Liste mit mehreren Zahlungsmethoden haben kann, müssen Sie sowohl die Customer-ID als auch die PaymentMethod-ID angeben, wenn Sie später eine Zahlung erstellen.

Nachfolgend finden Sie ein Beispiel für das Erstellen eines Customer-Objekts und die Zuordnung einer PaymentMethod:

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d name="Jenny Rosen" \
  --data-urlencode email="jenny.rosen@stripe.com" \
  -d payment_method={PAYMENT_METHOD_ID}

Rückerstattungen

Rückerstattungen werden mithilfe der Refunds API verwaltet und können entweder als vollständiger Betrag oder als Teilbetrag erfolgen. Um eine Transaktion mit Stripe zurückzuerstatten, benötigen Sie entweder die PaymentIntent-ID oder die Zahlungs-ID für die Transaktion, bei der die Rückerstattung durchgeführt werden soll.

Rückerstattungen verwenden Ihr verfügbares Stripe-Guthaben. Sie können nicht auf Ihr noch ausstehendes Guthaben zugreifen. Wenn Ihr verfügbares Guthaben nicht ausreicht, um den Rückerstattungsbetrag zu decken, bucht Stripe den Restbetrag von Ihrem Bankkonto ab. Sie können Teilrückerstattungen, vollständige Rückerstattungen und mehr als eine Rückerstattung gegen eine Gebühr vornehmen, aber Sie können keinen Gesamtbetrag zurückerstatten, der den ursprünglichen Zahlungsbetrag übersteigt.

Sie können Rückerstattungen mithilfe der API oder über das Dashboard ausstellen. Eine Rückerstattung kann nach Ausstellung nicht mehr storniert werden. Es dauert 5 bis 10 Werktage, bis die Rückerstattung auf der Kundenabrechnung erscheint. Wenn Kundinnen/Kunden nach dem Status ihrer Rückerstattung fragen, können Sie diesen die ARN mitteilen, damit diese bei ihrer Bank nachfragen können.

Nachfolgend finden Sie ein Beispiel für eine Rückerstattung für einen PaymentIntent:

curl https://api.stripe.com/v1/refunds \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d payment_intent={PAYMENT_INTENT_ID}

Sehen Sie sich das nachfolgende Beispiel für eine teilweise Rückerstattung mit einem angegebenen Betrag an:

curl https://api.stripe.com/v1/refunds \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d payment_intent={PAYMENT_INTENT_ID} \
  -d amount=1000

Zahlungsanfechtungen und Rückbuchungen

Ihr Unternehmen ist für den Umgang mit Zahlungsanfechtungen (auch als Rückbuchungen bezeichnet) verantwortlich. Wir empfehlen Ihnen, Zahlungsanfechtungen aktiv zu beobachten und Belege zu sammeln und einzureichen, um die Gültigkeit von Zahlungen gegebenenfalls belegen zu können. Wir halten angefochtene Gelder zurück und ziehen den Betrag von Ihrem Stripe-Guthaben ab, sobald eine Entscheidung getroffen wurde. Wenn die Zahlungsanfechtung zu Ihren Gunsten entschieden wird, erstatten wir Ihnen das Geld zurück.

Sie haben zwei Möglichkeiten, angefochtene Zahlungen zu beobachten:

• Verwenden Sie das Stripe Dashboard sowie E-Mail-Benachrichtigungen, welche Sie in Ihrem Dashboard-Profil einrichten können.
• Über die Disputes API können Sie die Antwort auf eine angefochtene Zahlung und die Übermittlung von Beweisen vollständig automatisieren.

Mithilfe von Webhooks können Sie Ereignisse erfassen, die in Ihrem Konto auftreten (z. B. Auszahlungen auf Ihr Bankkonto, Rückerstattungen, Zahlungen usw.). Sie sind hilfreich bei der Verarbeitung von asynchronen Stripe-Ereignissen oder bei Ereignissen, für die Sie zusätzliche Aktionen auslösen möchten.

Sehen Sie sich unseren empfohlenen Webhook für jeden Typ an:

Verwenden Sie die folgenden Ressourcen, um Ihre Webhooks einzurichten und zu überprüfen, ob sie korrekt konfiguriert wurden.

• Webhooks
• Webhook-Signaturen überprüfen
• Ereignistypen
• Best Practices für die Verwendung von Webhooks
• Webhook-Konfigurationen prüfen