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

Vipps-ZahlungenPrivate Vorschau

Erfahren Sie, wie Sie Zahlungen per Vipps akzeptieren, einer gängigen Zahlungsmethode in Norwegen.

Vipps ist eine einmalige Karten-Wallet-Zahlungsmethode, die in Norwegen verwendet wird. Sie ermöglicht Ihren Kundinnen und Kunden, Zahlungen mit der Vipps-App zu authentifizieren und zu genehmigen.

Wenn Ihre Kundin oder Ihr Kunde mit Vipps bezahlt, führt Stripe eine Kartentransaktion mit den von Vipps empfangenen Kartendaten durch. Die Verarbeitung der Kartentransaktion ist für Ihre Integration unsichtbar und Stripe benachrichtigt Sie sofort darüber, ob die Zahlung erfolgreich war oder fehlgeschlagen ist.

Vorsicht

Stripe passt die den Kundinnen/Kunden angezeigten Zahlungsmethoden automatisch an Währung, geltende Einschränkungen und andere Parameter an. Wir empfehlen Ihnen, Ihre Zahlungsmethoden im Dashboard zu konfigurieren und sich dabei an dem Artikel Zahlungen annehmen zu orientieren.

Wenn Sie die Zahlungsmethoden, die Sie Ihren Kundinnen und Kunden in Checkout anbieten, weiterhin manuell konfigurieren möchten, verwenden Sie bitte diese Anleitung. Andernfalls aktualisieren Sie Ihre Integration, um Zahlungsmethoden im Dashboard zu konfigurieren.

Dieser Leitfaden zeigt Ihnen, wie Sie Vipps auf Checkout, unserem gehosteten Bezahlformular aktivieren, und erklärt die Unterschiede zwischen der Annahme einer Kartenzahlung und einer Vipps-Zahlung.

Kompatibilität ermitteln

Für die Unterstützung von Zahlungen per Vipps muss eine Checkout-Sitzung alle folgenden Bedingungen erfüllen:

  • Die Preise für alle Posten müssen in norwegischen Kronen (Währungscode NOK) angegeben werden.

Stripe einrichten
Serverseitig

Zunächst benötigen Sie ein Stripe-Konto. Registrieren Sie sich jetzt.

Verwenden Sie unsere offiziellen Bibliotheken, um von Ihrer Anwendung aus auf die Stripe API zuzugreifen:

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

Zahlung akzeptieren

Notiz

Dieser Leitfaden beruht auf der grundlegenden Checkout-Integration für die Annahme einer Zahlung.

Aktivieren Sie Vipps als Zahlungsmethode

Führen Sie bei der Erstellung einer neuen Checkout-Sitzung folgende Schritte aus:

  1. Geben Sie bei Anfragen den Vorschau-Header vipps_preview=v1 mit Ihrer API-Version an
  2. Fügen Sie vipps zur Liste der payment_method_types hinzu
  3. Stellen Sie sicher, dass alle Ihre line_items die Währung nok verwenden.
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Stripe.api_version = '2025-03-31.basil; vipps_preview=v1'

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'vipps'],
  line_items: [{
    price_data: {
      currency: 'usd',
      # To accept `vipps`, all line items must have currency: nok
      currency: 'nok',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Abwicklung Ihrer Bestellungen

Informieren Sie sich über die Ausführung von Bestellungen, nachdem Sie eine Zahlung angenommen haben.

Ereignisse nach der Zahlung verarbeiten

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.

  • Manuelles Bearbeiten von Ereignissen im Dashboard

    Verwenden Sie das Dashboard, um Ihre Testzahlungen im Dashboard anzuzeigen, E-Mail-Belege zu senden, Auszahlungen zu bearbeiten oder fehlgeschlagene Zahlungen erneut zu versuchen.

  • Erstellen eines benutzerdefinierten Webhooks

    Erstellen Sie einen benutzerdefinierten Webhook-Handler, um auf Ereignisse zu hören und eigene asynchrone Zahlungsabläufe zu implementieren. Testen und debuggen Sie Ihre Webhook-Integration lokal mit der Stripe CLI.

  • Integrieren einer vorgefertigten App

    Bearbeiten Sie häufige Unternehmensereignisse, wie z. B.Automatisierung oderMarketing und Vertrieb, indem Sie eine Partneranwendung integrieren.

Integration testen

Um Ihre Integration in einer Testumgebung zu testen, werden Sie auf eine Testzahlungsseite weitergeleitet, auf der Sie die Testzahlung genehmigen oder ablehnen können.

Geben Sie im Live-Modus die mit Vipps verknüpfte Telefonnummer ein, um eine Push-Benachrichtigung an Ihre mobile Anwendung von Vipps zu senden. Sie können die Zahlung in der mobilen Vipps-App genehmigen oder ablehnen.

OptionalZahlung autorisieren und später erfassen

Vipps unterstützt die getrennte Autorisierung und Erfassung.

Stripe anweisen, nur die Autorisierung durchzuführen

Um anzugeben, dass Sie Autorisierung und Erfassung trennen möchten, legen Sie capture_method beim Erstellen der Checkout-Sitzung auf manual fest. Dieser Parameter weist Stripe an, nur den Betrag auf der Karte des Kunden/der Kundin zu autorisieren, der mit Vipps verknüpft ist.

Command Line
cURL
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-08-27.basil; vipps_preview=v1" \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=vipps \
  -d "line_items[0][price_data][currency]"=nok \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d "payment_intent_data[capture_method]"=manual \
  --data-urlencode success_url="https://example.com/success.html" \
  --data-urlencode cancel_url="https://example.com/cancel.html"

Nach erfolgreicher Autorisierung sendet Stripe das Ereignis payment_intent.amount_capturable_updated. Weitere Informationen finden Sie unter Ereignisse.

Die Gelder erfassen

Nach erfolgreicher Autorisierung wechselt der Status der PaymentIntent zu requires_capture, und Sie können die autorisierten Gelder erfassen. Stripe unterstützt nur die manuelle Erfassung des Gesamtbetrags.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents/
{{PAYMENT_INTENT_ID}}
/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount_to_capture=2000

OptionalStornierung

Sie können Vipps-Zahlungen stornieren, bevor sie ablaufen, indem Sie den PaymentIntent stornieren, der mit der Vipps-Zahlung verknüpft ist.

Fehlgeschlagene Zahlungen

Vipps-Transaktionen können fehlschlagen, wenn die zugrunde liegende Kartentransaktion abgelehnt wird. Weitere Infos zu Kartenablehnungen. In diesem Fall wird die PaymentMethod getrennt und der Status des PaymentIntent wechselt automatisch zu requires_payment_method.

Wenn der Status des PaymentIntent requires_action ist, muss Ihr Kunde/Ihre Kundin die Zahlung innerhalb von 5 Minuten authentifizieren. Wenn nach 5 Minuten keine Aktion erfolgt ist, wird die PaymentMethod getrennt und der Status des PaymentIntent wechselt automatisch zu requires_payment_method.

Rückerstattungen und angefochtene Zahlungen

Stripe führt eine Kartentransaktion mit Standard-Card-Rails im Rahmen einer Vipps-Transaktion durch. Rückerstattungen und Zahlungsanfechtungen unterliegen den Netzwerkregeln von Visa und Mastercard.

Siehe auch

War diese Seite hilfreich?
JaNein