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

Eine Klarna-Zahlung annehmen

Erfahren Sie, wie Sie Klarna, eine globale Zahlungsmethode für "jetzt kaufen, später bezahlen", akzeptieren können.

Wenn Ihre App Klarna akzeptiert, wird Kund/innen für die Authentifizierung der Zahlung eine Webansicht angezeigt. Anschließend kehrt der/die Kund/in zu Ihrer App zurück und Sie können sofort bestätigen, ob die Zahlung erfolgreich war oder fehlgeschlagen ist.

Notiz

Bevor Sie mit der Integration beginnen, vergewissern Sie sich, dass Ihr Konto für Klarna geeignet ist. Dies können Sie in Ihren Einstellungen für Zahlungsmethoden prüfen.

Stripe einrichten
Serverseitig
Clientseitig

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

Serverseitig

Diese Integration erfordert Endpoints auf Ihrem Server, die mit der Stripe-API kommunizieren können. Nutzen Sie diese offiziellen Bibliotheken für den Zugriff auf die Stripe-API von Ihrem Server aus:

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'

Clientseitig

Das Stripe Android SDK ist Open Source und vollständig dokumentiert.

Um das SDK zu installieren, fügen Sie stripe-android in den Block dependencies Ihrer app/build.gradle-Datei ein:

build.gradle.kts
Kotlin
Groovy
No results
plugins {
    id("com.android.application")
}

android { ... }

dependencies {
  // ...

  // Stripe Android SDK
  implementation("com.stripe:stripe-android:21.27.0")
  // Include the financial connections SDK to support US bank account as a payment method
  implementation("com.stripe:financial-connections:21.27.0")
}

Notiz

Details zur aktuellen SDK-Version und zu vorherigen Versionen finden Sie auf der Seite Releases auf GitHub. Um bei Veröffentlichung eines neuen Release eine Benachrichtigung zu erhalten, beobachten Sie Veröffentlichungen für das jeweilige Repository.

Konfigurieren Sie das SDK mit Ihrem veröffentlichbaren Schlüssel von Stripe so, dass dieser Anfragen an die API stellen kann, wie beispielsweise in Ihrer Unterklasse Application:

Kotlin
Java
No results
import com.stripe.android.PaymentConfiguration

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        PaymentConfiguration.init(
            applicationContext,
            
"pk_test_TYooMQauvdEDq54NiTphI7jx"

        )
    }
}

Notiz

Verwenden Sie Ihre Testschlüssel beim Testen und Entwickeln Ihrer App und Ihre Live-Modus-Schlüssel beim Veröffentlichen Ihrer App.

Stripe-Beispiele nutzen auch OkHttp und GSON, um HTTP-Anfragen an einen Server zu stellen.

PaymentIntent erstellen
Serverseitig
Clientseitig

Ein PaymentIntent ist ein Objekt, das Ihre Absicht, eine Kundenzahlung einzuziehen, darstellt und den gesamten Zahlungsvorgang dokumentiert.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_types[]"=klarna \
  -d amount=1099 \
  -d currency=eur

Clientseitig

Im zurückgegebenen PaymentIntent ist ein Client-Geheimnis enthalten, mit dem der Client den Zahlungsvorgang sicher abschließen kann, anstatt das gesamte PaymentIntent-Objekt zu übergeben. Fordern Sie auf dem Client einen PaymentIntent von Ihrem Server an und speichern Sie dessen Client-Geheimnis.

Kotlin
Java
No results
class KlarnaPaymentActivity: AppCompatActivity() {
    private lateinit var paymentIntentClientSecret: String

    override fun onCreate(savedInstanceState: Bundle?) {
        // ...
        startCheckout()
    }


    private fun startCheckout() {
        // Request a PaymentIntent from your server and store its client secret
    }
}

Zahlung an Stripe senden
Clientseitig

Rufen Sie von dem in Schritt 2 erstellten PaymentIntent das Client-Geheimnis ab und rufen Sie die Methode PaymentLauncher bestätigen auf. Dies entspricht einer Webansicht, über die der/die Kund/in die Zahlung durchführen kann. Anschließend wird onActivityResult mit dem Ergebnis der Zahlung aufgerufen.

Kotlin
Java
No results
class KlarnaPaymentActivity : AppCompatActivity() {
    // ...
    private lateinit var paymentIntentClientSecret: String
    private val paymentLauncher: PaymentLauncher by lazy {
        val paymentConfiguration = PaymentConfiguration.getInstance(applicationContext)
        PaymentLauncher.Companion.create(
            this,
            paymentConfiguration.publishableKey,
            paymentConfiguration.stripeAccountId,
            ::onPaymentResult
        )
    }

    private fun startCheckout() {
        // ...

        val confirmParams = ConfirmPaymentIntentParams
            .createWithPaymentMethodCreateParams(
                paymentMethodCreateParams = paymentMethodCreateParams,
                clientSecret = paymentIntentClientSecret,
                shipping = shippingDetails
            )
        paymentLauncher.confirm(confirmParams)
    }

    private fun onPaymentResult(paymentResult: PaymentResult) {
        when (paymentResult) {
            is PaymentResult.Completed -> {
                // show success UI
            }
            is PaymentResult.Canceled -> {
                // handle cancel flow
            }
            is PaymentResult.Failed -> {
                // handle failures
                // (for example, the customer may need to choose a new payment
                // method)
            }
        }
    }
}

Klarna-Integration testen

Nachfolgend haben wir speziell ausgewählte Testdaten für die derzeit unterstützten Kundenländer zusammengestellt. In einer Sandbox nutzt Klarna die angegebene E-Mail-Adresse, um eine Transaktion zu genehmigen oder abzulehnen.

GenehmigtAbgelehnt
Geburtsdatum10-07-197003.05.1994
VornameTestJohn
NachnamePerson-auschnee
StraßeWharf StSilverwater Rd
Hausnummer41 bis 5
Postleitzahl48772128
StadtPort DouglasSilverwater
RegionQLDNSW
Telefon+61473752244+61473763254
E-Mail-Adressecustomer@email.aucustomer+denied@email.au

Zwei-Schritte-Authentifizierung

Jede 6-stellige Zahl ist ein gültiger Code für die Zwei-Schritte-Authentifizierung. Verwenden Sie 999999, damit die Authentifizierung fehlschlägt.

Rückzahlungmethode

Innerhalb des Klarna-Ablaufs können Sie die folgenden Testwerte verwenden, um verschiedene Rückzahlungsarten auszuprobieren:

TypWert
LastschriftverfahrenDE11520513735120710131
BanküberweisungDemo-Bank
Kreditkarte
  • Nummer: 4111 1111 1111 1111
  • Prüfziffer: 123
  • Gültig bis: ein beliebiges gültiges Datum in der Zukunft
Debitkarte
  • Nummer: 4012 8888 8888 1881
  • Prüfziffer: 123
  • Gültig bis: ein beliebiges gültiges Datum in der Zukunft

OptionalGetrennte Autorisierung und Erfassung

Klarna unterstützt die getrennte Autorisierung und Erfassung. Wenn es zu einer Verzögerung zwischen der Zahlung und der Auslieferung des Kaufs an Ihre Kundinnen/Kunden kommt, sollten Sie die Zahlung zuerst zu autorisieren und später erfassen. Zum Zeitpunkt der Erfassung sendet Klarna eine Abrechnung an den Kunden/die Kundin und leitet die Fälligkeitsfristen für alle nachfolgenden Zahlungen ein, die er/sie leisten muss. Eine autorisierte Klarna-Zahlung muss innerhalb von 28 Tagen nach der Autorisierung erfasst werden. Andernfalls wird die Autorisierung automatisch storniert, und es ist nicht mehr möglich, diese Zahlung zu erfassen.

  1. Stripe anweisen, nur die Autorisierung durchzuführen

    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 auf dem Klarna-Konto der Kundin/des Kunden zu autorisieren.

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/payment_intents \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -d "payment_method_types[]"=klarna \
  -d amount=1099 \
  -d currency=eur \
  -d capture_method=manual

  2. Die Gelder erfassen

    Nachdem die Autorisierung erfolgreich war, wechselt der PaymentIntent-Status zu requires_capture. Um die autorisierten Gelder einzuziehen, senden Sie eine PaymentIntent-Capture-Anfrage. Standardmäßig wird der insgesamt autorisierte Betrag eingezogen – Sie können nicht mehr als diesen Betrag, aber durchaus weniger erfassen.

    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=750

  3. Optional Autorisierung stornieren

    Klarna rechnet alle autorisierten Zahlungen auf das gesamte Kaufkraftlimit des Kunden/der Kundin bei Klarna an. Stellen Sie sicher, dass Sie alle autorisierten Zahlungen, die Sie nicht erfüllen können (z. B. wenn die Ware nicht versendet werden kann), sofort stornieren, sobald dies erkennbar ist.

    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}}
    /cancel     \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -d cancellation_reason=abandoned

OptionalHandhabung von Ereignissen nach der Zahlung

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.

OptionalAnpassung der Klarna-Zahlungsseite

  • Klarna-Formular vorausfüllen

    Wenn die Kundin/der Kunde sich dafür entscheidet, mit einer aufgeschobenen Zahlungsoption von Klarna zu zahlen (später bezahlen, Ratenzahlungen oder Finanzierung), erhebt Klarna ausreichende Informationen für die Risikobewertung und Genehmigung. Welche Informationen erforderlich sind, hängt vom Land der Kundin/des Kunden ab. In den meisten europäischen Ländern sind dies die vollständigen Rechnungsdetails und das Geburtsdatum. Sie können diese Informationen über die API übergeben, sodass das Formular vorausgefüllt ist, wenn Ihre Kundin/Ihr Kunde auf der Seite ankommt.

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/payment_intents \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -d "payment_method_types[]"=klarna \
  -d amount=1099 \
  -d currency=eur \
  -d confirm=true \
  --data-urlencode return_url="https://example.com/checkout/complete" \
  -d "payment_method_data[type]"=klarna \
  --data-urlencode "payment_method_data[billing_details][email]"="customer@example.com" \
  -d "payment_method_data[billing_details][name]"="Jenny Rosen" \
  --data-urlencode "payment_method_data[billing_details][phone]"="+4915142321555" \
  -d "payment_method_data[billing_details][address][line1]"="Alexanderplatz 1" \
  -d "payment_method_data[billing_details][address][city]"=Berlin \
  -d "payment_method_data[billing_details][address][postal_code]"=10551 \
  -d "payment_method_data[billing_details][address][country]"=DE \
  -d "payment_method_data[klarna][dob][day]"=10 \
  -d "payment_method_data[klarna][dob][month]"=10 \
  -d "payment_method_data[klarna][dob][year]"=1990
    Screenshot einer Klarna-Zahlungsseite, die mit Rechnungsdaten aus der API vorausgefüllt und so angepasst wurde, dass sie auf Englisch dargestellt wird

    Eine Klarna-Zahlungsseite, die mit Rechnungsdaten aus der API vorausgefüllt und so angepasst wurde, dass sie für eine/n Kund/in in Deutschland auf Englisch dargestellt wird

OptionalPosten zum PaymentIntent hinzufügen

Einheitliche Einzelposten mit Klarna

Um die Genehmigungsraten bei der Integration mit Klarna zu optimieren, fügen Sie line_items-Daten hinzu, um darzustellen, was sich im Warenkorb eines Käufers/einer Käuferin befindet. Informationen zum frühzeitigen Zugriff finden Sie unter Zahlungsposten.

Fehlgeschlagene Zahlungen

Klarna berücksichtigt mehrere Faktoren bei der Entscheidung, ob eine Transaktion akzeptiert oder abgelehnt wird (zum Beispiel die Dauer der Nutzung von Klarna durch den/die Käufer/in, den ausstehenden Betrag, den der/die Kund/in zurückzahlen muss, oder den Wert der aktuellen Bestellung).

Wenn Kund/innen eine Zahlungsmethode mit Zahlungsaufschub wählen, führt Klarna eine Risikoeinschätzung durch, bevor die Transaktion akzeptiert wird. Klarna kann die Transaktion ablehnen, wenn das Ergebnis der Risikoeinschätzung nicht zufriedenstellend ist, es sich um einen hohen Transaktionsbetrag handelt oder der Kunde/die Kundin hohe Außenstände hat. Wir empfehlen daher, dass Sie bei Ihrem Bezahlvorgang zusätzliche Zahlungsoptionen wie card angeben. In diesen Fällen wird die PaymentMethod getrennt und der Status des PaymentIntent-Objekts wechselt automatisch zu requires_payment_method.

Es wird erwartet, dass Kundinnen/Kunden die Zahlung innerhalb von 48 Stunden nach Weiterleitung zur Klarna-Website abschließen. Wenn nach 48 Stunden keine Aktion erfolgt ist, wird die PaymentMethod getrennt, und der Status des PaymentIntent-Objekts wechselt automatisch von requires_action zu requires_payment_method.

Teilen Sie Ihren Kund/innen in diesen Fällen mit, dass sie es mit einer anderen Zahlungsoption versuchen sollten, die in Ihrem Bezahlvorgang zur Verfügung gestellt wird.

Ratenbegrenzungen von Klarna

API-Anfragen an Klarna unterliegen zusätzlichen Begrenzungen, die über die API-weiten Begrenzungen von Stripe hinausgehen. Diese Grenzwerte können je nach Form der API-Anforderungen, die Sie stellen, unterschiedlich sein. Wenn Sie mehr als 50 Anforderungen pro Sekunde stellen, kann es im Allgemeinen zu einer Begrenzung in Form von Antworten mit HTTP-Statuscode 400 oder402 kommen.Kontaktieren Sie uns wenn Sie befürchten, dass Ihr Nutzung diese Werte erreichen könnte, da Klarna diese Grenzwerte von Fall zu Fall eventuell erhöhen kann.

Fehlermeldungen

Fehlgeschlagene Klarna-Zahlungen geben üblicherweise einen der folgenden Fehlercodes zurück. Diese Codes werden im API-Objekt last_payment_error angezeigt.

Vorsicht

Vor der API-Version 2023-08-16 wurde jeder Klarna-Fehler als payment_intent_authentication_failure gemeldet. Stellen Sie sicher, dass Ihre API-Version auf dem neuesten Stand ist, um die unten aufgeführten detaillierten Fehler anzuzeigen.

FehlercodeErklärung
payment_method_customer_declineDie Kundin/der Kunde hat den Bezahlvorgang auf der Seite von Klarna abgebrochen.
payment_method_provider_declineKlarna hat die Kundenzahlung abgelehnt.
payment_intent_payment_attempt_expiredDie Kundin/der Kunde hat den Bezahlvorgang auf der Seite von Klarna nicht abgeschlossen und die Zahlungssitzung ist abgelaufen.
payment_method_not_availableBeim Aufruf von Klarna ist ein unerwarteter Fehler aufgetreten.
War diese Seite hilfreich?
JaNein