Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Zahlungsmethoden
Zahlungsschnittstellen
Zahlungsszenarien
Präsenzzahlungen
Mehr als Zahlungen

Swish-ZahlungenNur auf Einladung

Erfahren Sie, wie Sie Zahlungen per Swish, einer beliebten Zahlungsmethode in Schweden, akzeptieren.

Swish ist eine in Schweden verwendete Zahlungsmethoden zum einmaligen Gebrauch. Sie bietet Kundinnen und Kunden die Möglichkeit, Zahlungen mit der mobilen Swish-App und der schwedischen mobilen BankID-App zu authentifizieren und zu genehmigen.

Sie erhalten eine sofortige Benachrichtigung, ob die Zahlung erfolgreich war oder fehlgeschlagen ist.

Erforderliche Hinweise

Um die Swish-Regeln einzuhalten, müssen Sie in Ihrem Zahlungsablauf den folgenden Text anzeigen, bevor die Kundin/der Kunde die Swish-Zahlung autorisiert:

  • Für englische Lokalisierungen: „Stripe Technology Europe Limited („Stripe“) has acquired the claim for payment. Therefore your payment will be made to Stripe.“
  • Für schwedische Lokalisierungen: „Stripe Technology Europe Limited („Stripe“) har övertagit fordran på betalning. Din betalning görs därför till Stripe.”
  • Für andere Sprachen eine gleichwertige Übersetzung des Vorstehenden.

Wenn Sie Swish über ein von Stripe gehostetes Zahlungsformular oder eine von Stripe gehostete Nutzeroberfläche wie Checkout oder das Payment Element integrieren, zeigt Stripe Ihnen diesen Hinweis an.

Stripe einrichten
Serverseitig

Nutzen Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe-API über Ihre Anwendung:

Command Line
Ruby
Python
PHP
Java
Node
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
Ruby
Python
PHP
Java
Node
Go
.NET
No results
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Erstellen Sie ein PaymentIntent
Serverseitig

Ein PaymentIntent ist ein Objekt, das Ihre Absicht, eine Zahlung von Kundinnen und Kunden einzuziehen, darstellt und den gesamten Zahlungsvorgang dokumentiert. Erstellen Sie zunächst einen PaymentIntent auf Ihrem Server und geben Sie den einzuziehenden Betrag und die Währung an. Falls Sie bereits über eine Integration verfügen, die die Payment Intents API verwendet, fügen Sie der Liste der Zahlungsmethoden für Ihren PaymentIntent die Zahlungsmethode swish hinzu.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=6000 \
  -d currency=sek \
  -d "payment_method_types[]"=swish \
  -d "payment_method_data[type]"=swish \
  -d "payment_method_options[swish][reference]"=Order-123

Hinweis

Sie können festlegen, dass die Bestellreferenz Ihren Kundinnen/Kunden in der Swish-App angezeigt wird.

Antwort

{
  "id": "pi_12345",
  "amount": 6000,
  "client_secret": "pi_12345_secret_abcdef",
  "currency": "sek",
  "payment_method": "pm_12345",
  "payment_method_types": [
    "swish"
  ],
  "payment_method_options": {
    "swish": {
      "reference": "Order-123",
    },
  },
  "status": "requires_confirmation"
}

Client-Geheimnis abrufen

Im PaymentIntent ist ein Client-Geheimnis enthalten, das auf dem Client verwendet wird, um Zahlungen sicher abzuschließen. Es gibt verschiedene Verfahren zum Übergeben des Client-Geheimnisses an den Client.

Rufen Sie das Client-Geheimnis von einem Endpoint auf Ihrem Server ab, indem Sie die Browser-Funktion fetch verwenden. Diese Vorgehensweise funktioniert am besten, wenn es sich bei Ihrer Client-Seite um eine einseitige Anwendung handelt, insbesondere wenn sie mit einem modernen Frontend-Framework wie React erstellt wurde. Erstellen Sie den Server-Endpoint, der das Client-Geheimnis bereitstellt:

main.rb
Ruby
Python
PHP
Java
Node
Go
.NET
No results
get '/secret' do
  intent = # ... Create or retrieve the PaymentIntent
  {client_secret: intent.client_secret}.to_json
end

Und dann rufen Sie das Client-Geheimnis mit JavaScript auf der Client-Seite ab:

(async () => {
  const response = await fetch('/secret');
  const {client_secret: clientSecret} = await response.json();
  // Render the form using the clientSecret
})();

PaymentIntent bestätigen

Verwenden Sie die ID des PaymentIntent aus Schritt 2, um den PaymentIntent zu bestätigen. Dadurch wird erklärt, dass die Kundin/der Kunde beabsichtigt, mit der angegebenen PaymentMethod zu bezahlen. Nachdem der PaymentIntent bestätigt wurde, wird die Zahlung eingeleitet. Die return_url gibt an, wohin Stripe Nutzer/innen nach dem Zahlungsabschluss weiterleitet.

Initiieren Sie die Swish-Zahlung, indem Sie den Payment Intent bestätigen. Geben Sie eine return_url an, an die Ihre Kundinnen und Kunden weitergeleitet werden, nachdem die Zahlung abgeschlossen ist.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents/
{{PAYMENT_INTENT_ID}}
/confirm \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode return_url="https://example.com/checkout/complete"

Antwort

{
  "id": "pi_12345",
  "amount": 6000,
  "currency": "sek",
  "payment_method": "pm_12345",
  "next_action": {
    "swish_handle_redirect_or_display_qr_code": {
      "hosted_instructions_url": "https://stripe.com/hiu-pi_123",
      "qr_code": {
        "data": "abc123",
        "image_url_png": "https://qr.stripe.com/qr_123.png",
        "image_url_svg": "https://qr.stripe.com/qr_123.svg"
      }
    },
    "type": "swish_handle_redirect_or_display_qr_code"
  },
  "payment_method_types": [
    "swish"
  ],
  "payment_method_options": {
    "swish": {
      "reference": "Order-123",
    },
  },
  "status": "requires_action"
}

Um die Zahlung zu autorisieren, leiten Sie Ihre Kundin/Ihren Kunden an die URL im Feld next_action[swish_handle_redirect_or_display_qr_code][hosted_instructions_url] weiter oder laden Sie diese Seite in einen iframe. Auf dieser Seite finden QR-Code als auch eine Schaltfläche, die Sie an die Swish-App weiterleiten können.

  • Desktop-Nutzer/innen können den QR-Code mit der Swish-App scannen und anschließend die Zahlung autorisieren.

  • Nutzer/innen mobiler Geräte können auf eine Schaltfläche klicken, die zur Swish-App weiterleitet, wo sie die Zahlung autorisieren können.

Hinweis

Ihr Kunde/Ihre Kundin hat 3 Minuten Zeit, die Zahlung in der Swish-App zu autorisieren. Danach schlägt die Zahlung fehl und der Payment Intent wechselt zu requires_payment_method.

Wickeln Sie die Bestellung ab
Serverseitig

Verwenden Sie eine Methode wie Webhooks, um die Ausführung von Bestellungen abzuwickeln. Wenn eine Kundin/ein Kunde die Zahlung abschließt, wechselt der Status des PaymentIntent zu succeeded und das Webhook-Ereignis payment_intent.succeeded wird gesendet. Wenn eine Kundin/ein Kunde nicht zahlt, sendet der PaymentIntent das Webhook-Ereignis payment_intent.payment_failed und wechselt wieder in den Status requires_payment_method.

Fehlgeschlagene Zahlungen

Swish verwendet mehrere Datenpunkte, um zu entscheiden, wann eine Transaktion abgelehnt wird (zum Beispiel ist das Kundenguthaben auf dem Bankkonto nicht ausreichende oder die Kundin/der Kunde hat in der App auf Abbrechen geklickt).

In diesen Fällen wird die PaymentMethod getrennt und der Status des PaymentIntent-Objekts wechselt automatisch zu requires_payment_method.

Anders als bei einer abgelehnten Zahlung müssen Kundinnen/Kunden bei einem Swish-PaymentIntent mit dem Status requires_action die Zahlung innerhalb von 3 Minuten nach abschließen. Wenn nach 3 Minuten keine Aktion erfolgt ist, wird die PaymentMethod getrennt, und der Status des PaymentIntent-Objekts wechselt automatisch zu requires_payment_method.

War diese Seite hilfreich?
JaNein